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Customer Support 
Information 



Introduction 



This document describes the release and installation of OS/MP 4. IB. 

OS/MP 4. IB is a "full" installation that you can use to: 

□ install OS/MP 4. IB on a Solboume system 

a add support to a server for an OS/MP 4. IB client 

n repartition a hard disk drive 

This release applies to the following Solboume architectures: SeriesS, SeriesSE, 
Series6, and Series S4000 systems. In these release notes, the term "Series S4000," 
or simply "S4000," refers to aU Solboume S4000, S4000DX, and S3000 systems; 
also "SeriesS" refers to both SeriesS and SeriesSE architectures. 

OS/MP 4. IB offers basic binary application compatibility with SunOS 4. 1.2 and 
4.1.3. 



If you have problems installing or using the features included in the Solboume 
OS/MP 4. IB release, call the Solboume toll free support number, 1-800-447-2861, 
if you are within the United States. Customers outside the U.S. should caU their lo- 
cal Solboume representative. If you have purchased a support contract that in- 
cludes support for OS/MP 4. IB from Solboume, this service is provided at no extra 
charge. 

When you call, please be prepared to give the following information about your 
system: 

□ Model number (such as Series5/602 or S4000) 

□ Serial number 

D Solboume OS/MP release number (4. 1 B) 

The system's model number and serial number can usually be detemiined using the 
eeprom(8) command, as in the following: 

(^# /tiSir/.fefcc/^ep£&ttL MODEL SSRX&L- . • ) 
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To check the Solboume OS/MP release number, enter the cat command as shown 
below: 



oat /«to/xftot4 
0^/i^ 4k IB KKpoct(<5ei^SJtXC/root;}#5: tme May 26 ll:36i06X992 

To request OS/MP patches: 

□ call the SOURCE at 1-800-447-2861 

□ e-mail support@solboume.com 

O via anonymous ftp from solboume.solboume.com at 14 1 . 1 38.2.2. Log in as 
anonymous and use the password ftp. The patches are in pub/support/OS/MP 
4. 1 B . An index file describes the set of available patches and whether the patch 
is mandatory or optional. 

□ via the listserv system SOLIS (Solboume On-Line Information System) by e- 
mailing solis(a)solboume.com 

If you have questions about Solboume 's support services or your shipment, call 
your Solboume sales representative. 



Documentation 
Conventions 



In the body of this document, commands and file names are presented in boldface 
and conunand parameters for which you substitute a value are italicized. User input 
instmctions and examples are presented in a constant width font. In these notes, the 
following convention is followed: 

O Information displayed by the system is given in normal constant 
width. 

D Information you enter is displayed in bold constant width. 

a Variables for which you substitute a value are shown in obi i gu e 
constant width. 



Definitions 



local A device that is physically connected to the system being installed. For ex- 
ample, a local disk drive. 

remote A device that is physically connected to a system other than the system be- 
ing installed. For example, a remote tape drive. 

package The components of a distribution are referred to as packages. Examples 
of packages are FORTRAN 1.4, X Windows, and Solboume OS/MP Optional 
Software for S4000. 

ramdisk image The ramdisk image is a special UNIX kemel with a built-in RAM 
disk that contains the installation software. 
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server A system that is on a network and may provide NFS disk services. 

client A system that uses NFS services provided by another system. A diskftil sys- 
tem with root(/), swap, and /usr on a local disk. 

diskless A system whose root(/), swap, and /usr filesystems are provided by a 
server, instead of a local disk. 

dataless A system whose /usr filesystem is on a remote disk and whose root (/) 
filesystem and swap disk partition are on a local disk. 

standalone A system that has no networking. It also does not depend on a server 
for its root, swap, or /usr filesystems. 

filesystem A set of files and directories that reside on one disk partition. The term 
is also used to refer to the swap area, even though the swap area does not actually 
contain files and directories. 

hostnumber The host portion (the last number of a class C address) of the Internet 
Protocol address. For example, if the Internet address is 192.1.3.42, the hostnum- 
ber is 42. 



Physical Elements of this 
Release 



This release contains the following items: 

Table 1. Physical Elements of the OS/MP 4. IB Release 



Part Number 


Description 


106197 
106200 
106202 


1/4-inch QIC- 150 OS/MP 4. IB tape, or 
8mm Exabyte OS/MP 4. IB tape, or 
CD-ROM OS/MP 4. IB disk 


106190 


Release and Installation Notes for OS/MP 4. IB 
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Contents of the OS/MP 
4.1B Tape 



Table 2. Contents of OS/MP 4. IB Tape 



FUe 

# 


FUe 


Format 


Size 
(KB) 





Table of Contents 


dd 


2 


1 


Package Description File for Full 4. IB Installation 


dd 


2 


2 


Series5 Installation Kernel 


dd 


6801 


3 


Series6 Installation Kernel 


dd 


6848 


4 


S4000 Installation Kernel 


dd 


6476 


5 


Tools files 


tar 


296 


6 


Miniusr 


dd 


18432 


7 


Root files 


tar 


6780 


8 


Series5 kvm files 


tar 


11280 


9 


Series6 kvm files 


tar 


11392 


10 


S4000 kvm files 


tar 


9984 


11 


Usr files 


tar 


28512 


12 


debugging files 


tar 


2888 


13 


games files 


tar 


3136 


14 


man files 


tar 


7520 


15 


networking files 


tar 


1056 


16 


graphics files 


tar 


1784 


17 


security files 


tar 


312 


18 


sunview_programmers files 


tar 


1848 


19 


sunview_users files 


tar 


3064 


20 


system_v files 


tar 


4032 


21 


text files 


tar 


720 


22 


versatec files 


tar 


5960 


23 


uucp files 


tar 


608 


24 


rfs files 


tar 


928 


25 


shlib_custom files 


tar 


1376 


26 


tli files 


tar 


48 
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Performance 
Improvements 



OS/MP Enhancements 



OS/MP 4. IB incorporates many performance improvements. These improvements 
were obtained by multithreading kernel subsystems that were previously single- 
threaded, improving already multithreaded subsystems, and optimizing critical 
code paths. 

D In a multiprocessing kernel, locks are constantly acquired and released during 
context switching. This is a critical code path in the kernel. The new locking 
scheme lets you turn on lock debugging dynamically, realizing a 30% 
improvement in context switch times. 

□ UNIX system pipes are implemented as a pair of UNIX system domain 
sockets. Since pipes are used frequently, improving their performance is 
especially important. Multithreading this subsystem not only improved the 
performance of pipes, it optimized performance for those who use UNIX 
system domain sockets for synchronization. In addition, parallelizing UNIX 
system domain sockets also parallelized the following system calls: 



pipe 


bind 


recvfrom 


socket 


setsockopt 


sendto 


connect 


listen 


shutdown 


accept 


recvmsg 


socketpair 


send 


sendmsg 


getpeername 


recv 


getsockopt 


getsockname 



n The select system call was optimized for RDBMS apphcations. 

O The SCSI subsystem has been multithreaded in OS/MP 4. IB. This speeds up 
the raw I/0-to-SCSI subsystem. Databases using raw I/O with SCSI disks will 
benefit from this improvement. 
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a The file table, the credentials, and some system accounting functions were 
parallelized. The following system calls were made parallel as a result. 

close dup ioctl 

fstat dup2 fcntl 

a OS/MP has a new Hardware Address Translation (HAT) layer. The HAT layer 
manages the hardware aspects of virtual memory. The OS/MP 4. IB 
improvements allow larger kernel configurations which, in turn, increase the 
number of maxusers. 

B Fork, exec, and exit, which were parallelized in OS/MP 4.1A.3, were 
further improved in OS/MP 4. IB. 

□ OS/MP 4. IB also includes reader/writer locking primitives. 

□ A number of bugs have been fixed in both the static and dynamic link editors. 
These fixes have been available in patches to /usr /bin/ Id and 
/usr/lib/ld.so. There are no enhancements or other functional changes 
as a result of these repairs. 

However, one of the repairs corrects a problem (Sun Bug ID 1019004) and 
reveals bugs in other parts of the system. Specifically, this bug allowed the 
construction of programs that silently permitted inclusion of shared libraries 
having unresolved references. The bug fix makes the link editing of programs 
using such libraries now report errors where previously the link editing 
operation appeared to have completed successfully. 

In many cases, the unresolved references were never used. Therefore, no 
problem ever appeared, even though such libraries are, strictly speaking, 
incorrectly constructed. In other cases, such as for users reporting Sun Bug 
1019004, the failure to report the unresolved reference permitted users to 
believe they had correct programs. Then, during execution, the dynamic link 
editor would report the unresolved reference. 

Another repair (to Sun Bug ID 1052428) restricts the behavior of the dynamic 
loader library search algorithm for set-user- or set-group-id programs. 

Unsupported Software 
Features 

The following software features are not supported in OS/MP 4. IB. 

□ DES encryption facilities are supported through a separately available release 
tape. 

• /usr/bin/crypt 

• /usr/bin/des 

n Loadable modules are not supported. 

n Device drivers are not binary compatible with SunOS 4. 1 .2 or 4. 1 .3. 

O There is no support for new hardware with extended VME addressing. 
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n "Special" drivers, including any and all device drivers from third-party 

vendors or Solboumc Tactical Engineering, may or may not work with OS/MP 
4.1B. If "special" drivers are installed on your machine, you may need to 
contact our driver suppliers. 



System Architectures 



SunView 



□ The following files are not included in OS/MP 4. 1 B : 



/usr/etc/gpconfig 
/usr/lib/*.ucode 



Solboume systems have an application architecture of **sun4". This is the output 
printed by arch(l). The kernel architecture is either "SeriesS", "Series6", or 
"S4000.*' These are the outputs printed by arch -k The exit code for arch sun4 is 
0; for other argument values, the exit code is 1. 



Version 1.8 of SunView is included with OS/MP 4. IB. This is the same version 
currently available fiom Sun. The SunView application dbxtool is not included. 



Configuring a Kernel 



The type of kernel you can configure depends on the kernel architecture of the ma- 
chine, which may be determined using the arch -k command. 

To configure a Series S4000 kernel, change directory to /sys/idt/conf and use con- 
fig(8). The generic kernel configuration file is named GENERIC. Refer to the file 
/sys/idt/conf/README for more information on customizing a kernel. 

To configure a SeriesS, Series5E, orSeries6 kernel, change directory to/sys/kbus/- 
conf and use config(8). The generic kernel configuration file is named GENERIC. 
Refer to the file /sys/kbus/conf/README for more information on customizing a 
kernel. 

The kernel configuration files fi-om previous OS/MP releases are not compatible 
with the kernel configuration files for OS/MP 4. IB. Compare your previous kernel 
configuration file with die generic OS/MP 4. 1 B kernel configuration file and make 
the corresponding changes to the OS/MP kernel configuration file. 

The generic kernel does not provide configuration information for the Multi-Chan- 
nel Accelerator Board. Refer to the System and Network Administration manual 
and the Release Notes for the Multi-Channel Accelerator Board. 

The generic kernel does provide configuration information to support two VMEbus 
Cougar controllers and two BoSS enclosures. Refer to the BoSS Release Notes and 
Update Pages ipdiTimxmbcY\06\^\). 
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Series6 CPU Board 
Support 



Supported Hardware 



The OS/MP 4. IB release supports the hardware listed in this section. Solboume 
provides installation instructions with each supported peripheral. 



Software support for Solboume's Series6 CPU board is introduced in OS/MP 4. 1 B. 
The Series6 CPU board may only be installed in Series 700 and Series 900 systems. 
The following new ROM commands have been added to the in-circuit bootROM 
to support the Series6: 

n cpustatus: displays the bootROM version strings for each CPU in the system. 
It also displays any CPU that has failed the power-on self-test. 

□ romcopy: copies the ROM firmware from one CPU board to another. To do 
this, the CPU containing the ROM firmware to be copied must be made the 
master CPU. 

The following command was modified to support the Series6CPU board: 

D arch 

Please refer to the Series6 CPU Board Release Notes and Update Pages (part num- 
ber 106145), and the man pages cpustatus(8), and romcopy(8) for more informa- 
tion. 



Banks Of SCSI Storage 



Software support for Banks of SCSI Storage (BoSS) is introduced in OS/MP 4. 1 B. 
BoSS may only be installed in Series 700 and Series 900 systems. The following 
commands have been changed to support BoSS: 

□ fsck 

n partition 

a inst_sys 

□ svstat 

□ sysdiag 
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Please refer to the Solbourne BoSS Release Notes and Update Pages (part number 
106181) for more information. 



Disk Drives 



Table 3 lists the disk drives supported in the OS/MP 4. IB release. 

Table 3. Supported Disk Drives 



Device 


Bus 


Name 


830 Ml )yte SMD Hard Disk Drive 


VMEbus 


xd 


1040 Mbyte SMD Hard Disk Drive 


VMEbus 


xd 


1 .2 Gby te IPI Hard Disk Drive 


VMEbus 


xd 


3.0 Gbyte IPI Hard Disk Drive 


VMEbus 


xd 


327 Mbyte Hard Disk Drive (5 1/4-inch) 


SCSI 


sd 


661 Mbyte Hard Disk Drive (5 1/4-inch) 


SCSI 


sd 


1 Gbyte Hard Disk Drive (3 1/2-inch) 


SCSI 


sd 


1.3 GbyteHard Disk Drive (5 1/4-inch) 


SCSI 


sd 


500 Mbyte Hard Disk Drive (3 1/2-inch) 


SCSI 


sd 


200 Mbyte Hard Disk Drive (3 1/2-inch) 


SCSI 


sd 


1.44 Mbyte Floppy Disk Drive (3 1/2-inch) 


- 


fdO 


CD ROM Drive 


SCSI 


srO 



The "LXT213" entry in /etc/format.dat is not supported by Solbourne. The 
"LXT200" entry should be used mstead. Solbourne treats the LXT200 and 
LXT213 drives identically and formats both types to 200 Megabytes before ship- 
ping. Solbourne may ship one type as a replacement for the other. 

The floppy disk drive is available only on Series S4000 machines. Other non-SCSI 
devices are not available on Series S4000 machines. 

All hard disk drives are shipped with a default partitioning. 
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Tape Drives 



Table 4 lists the tape drives supported in the OS/MP 4. IB release. 

Table 4, Supported Tape Drives 



Tape Drive 


Bus 


Name 


QIC-150 


SCSI 


St 


8mm Cartridge 


SCSI 


St 



Tape drives are accessed via entries in/dev, all tape drives are on the SCSI bus. 
MAKEDEV creates mt devices by making hard links to the corresponding st de- 
vice; /dev/rstO is identical to /dev/rmtO and either name can be used to access the 
tape For devices that support multiple densities, consult the (4) manual page for in- 
formation on how to manipulate the unit number to access the various densities. 
Tape operations are on the character (raw) device, such as /dev/rstO; /dev/stO is the 
block device. 



(n) r s t 



no rewind 



raw 



tape 



SCSI 



The dump and restore commands have been modified to use a media database, 
/etc/media. The M option causes dump and restore to consult the database to de- 
termine the blocking factor, length and density to maximize the tape use. Use the 
following command to dump file systems: 



(# d\m^ OMjg fli6di a. /dftv/iucstiB fil ^sy^t ^tit 



J 



where /nedi a is the media type described below and file sys t em is the file sys- 
tem to dump. Use /dev/nrst9 if the tape drive is set to SCSI id 0x5 (stl). 

Table 5 gives a sampling of the different media types described in the /etc/media 
file. Additional media types may be added by editing /etc/media. Refer to the me- 
dia(5) man page for details of this database. 

Table 5. Examples of Media lypes 



Media 


Format 


Description 


Q150_600 


QIC-150 


1/4-inch 600-foot XTD tape 


P6-120 


466033 


8mm cartridge tape 
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• • • NOTE • • • 

dump indicates it is rewinding the tape even when using a no-rewind name. Ignore 
the message. 

For example, the following command gives the maximum tape use for a QIC- 150 
with a 600 XTD tape: 



(^# dtomp QU£ ^150^600 /dBv/nrsti/uar 



J 



The generic kernel supports two SCSI tape drives. To add a first or second tape 
drive, power down the system, plug in the drive and reboot. One drive must be set 
to SCSI id 0x4, >yhile the other drive must be set to SCSI id 0x5 to be recognized. 
See the hardware installation manual for the device to determine how to set the 
drive to the appropriate SCSI ID. I 

To add more tape drives, the kernel must be reconfigured. A maximum of eight 
tape drives may be configured. The following example details how to reconfigure 
a kernel for three SCSI tape drives. 



1 . Create a kernel configuration file to edit: 






2. Edit the 3TAPES file. 

a. Go to the line that contains : 



Q tape stl 'at- jsiQdgJy;^. ' 



J 



b. Add this line: 



c. Comment out (insert a *#' at the beginning oO this line: 



D 



(]d.lsk' srOat siO drive 0i£06 



J 



3. Runconfig: 



^ usr/et;G/co»f icf STAPES 
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4. Build the kernel: 



^^.^^.^^^ 



# mv /vmunia! /vnwnix.orig 

# cp vsEwnisc / 

# reboot^ 



The following list gives specific information about the supported tape drives: 

QIC-150 The QIC-150 drive has the capacity to store 150 Megabytes 

when using 3M 600 XTD tapes. When reading tapes using the QIC-150 drive, the 
tape foraiat (QIC-150, 120, 24, or 11) is automatically detected by the tape unit; 
therefore, tapes created with a QIC-24 drive can be read with the QIC-150 drive. 
The drive always writes QIC-150 format 

8mm Cartridge This drive has the capacity to store 2 Gbytes on the 8200, and 
5Gbytes on the 8500, when used with P6-120 8mm cartridge tapes. 



Network Controllers 



Table 6 lists the Network controllers supported in the OS/MP 4. IB release. 
Table 6. Supported Network Controllers 



Device 


Name 


System Board Ethernet controller 


eiO 


Sbus Ethernet controller (Series S4000) 


eil 


Channel Board Ethernet conu-oller (Series 5, 5E, and 6) 


eil 


VMEbus Ethernet controller 


egO 


FDDI controller 


pgO 



The System Board Ethemet controller is a standard component. The Sbus Ethemet 
controller (usable on the S4000 Series) is available from third-party vendors. To 
add the Sbus Ethemet gateway, install the card in the system and make the indicat- 
ed changes to these files: 

file add following 

/etc/hosts internet_address gatewayname line containing 'localhost' 

/etc/hostname.eil gatewayname (create new file) 
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The I/O ASIC Ethernet controller is standard on Series 5, 5E, and 6 systems. To 
add the VMEbus Ethernet gateway on one of these systems, install the controller 
in the system and make the indicated changes to these files: 

file add following 

/etc/hosts internet_address gatewayname line containing 'localhost' 

/etc/hostname.egO gatewayname (create new file) 

• ••NOTE*** 

If your network uses Network Information Service (NIS), the internal jiddr ess and 
gateway must be added to the maps on the NIS/YP master as well as the local 
fetdhosisfde. 

gatewayname is the name for the Ethemet interface, often hostnamejgw, it must be 
distinct from the name used for the onboard interface. The Sbus Ethemet controller 
is configured into the generic kernel. After you have made these changes, reboot 
the system. 



Serial Multiplexers 



The generic kernels forkbus systems (Series5, SeriesSE, and Series6) support four 
serial mux controllers. Each serial mux controller supports 16 lines. Modiiy the 
maxusers setting on the kernel depending on the number of serial mux controllers 
in the system. To modify maxusers, edit the appropriate kemel configuration file 
in /sys/kbus/conf and set maxusers equal to the quantity ((number_of_serial_- 
mux_boards * 16) + 8). After you have modified the configuration file, configure 
and build a kemel. 



Floppy Disk Drives 



Series S4000 machines contain an optional 3.5-inch floppy drive. This drive sup- 
ports two different densities. The low density is 720K (formatted) and tiie high den- 
sity is 1.44Mb (formatted). Diskettes may be interchanged witii Sun SPARCstalion 
systems. Solboume provides a utility, pcnfs, to read and write MS-DOS-compaU- 
ble diskettes. 

Several OS/MP 4. IB commands work witii the floppy drive. Please refer to the ap- 
propriate manual pages for details. 

n fdformat(l) is used for formatting a diskette. By default fdformat assumes 
that a high density diskette is in the drive. If a low density diskette is being 
foraiatted, the -1 (for ' 'low ' ') option should be used. 

□ eject(l) is used to remove the diskette from tiie drive. 

n bar(l) can be used to dump a file or files to the diskette that nonnally would 
not fit. When bar completes writing to one diskette, the diskette will be ejected 
and a request for a second diskette will be made 
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The /dev entries for the floppy are shown in Table 7: 

Table 7. Floppy /dev Entries 



Device 


Partition 


/dev/rfdOa 


partition A on the raw disk 


/dev/rfdOb 


partition B 


/dev/rfdOc 


partition C 


/dev/rfdO 


same as partition C 


/dev/fdOa 


partition A on the diskette using block mode 


/dev/fdOb 


partition B 


/dev/fdOc 


partition C 


/dev/fdO 


same as partition C using block mode 



Keyboards and Consoles 



Keyboards 



OS/MP 4. IB supports the international keyboard layouts provided in SunOS 4. 1 .2, 
and supports two keyboard styles: a PC-style keyboard and an engineering-style 
keyboard. 

The international keyboards provided are installed by setting the ROM environ- 
ment variable KBD_LAYOUT to the appropriate hex value, x (shown in Table 8). 
For example: 

ROM> setenv KBDLAYOUT Ojc 

Table 8. Country hex values 



Country 


Hex Value 


US 


00 


FRANCE_BELGIUM 


02 


CANADA.FRENCH 


03 


DENMARK 


04 


GERMANY 


05 


ITALY 


06 


NETHERLANDS 


07 


NORWAY 


08 
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Table 8. Country hex values 



Country 


Hex Value 


PORTUGAL 


09 


SPAIN.LATINAMERICA 


Oa 


SWEDEN.FDSfLAND 


Ob 


SWITTFRLAND FRENCH 


Oc 


SWIT7F,RLAND GERMAN 


Od 


UK 


Oe 


JAPAN 


20 



The PC-style keyboard is compatible with Sun's Type-4 keyboard. OS/MP 4. IB 
maps the PC-style keyboard so it is identical to Sun's Type-4 keyboard. Applica- 
tions that expect the Type-4 keyboard, such as editors, will recognize the PC-style 
keyboard as a Type-4. 

The Engineering-style keyboard is compatible with Sun's Type-3 keyboard. 
OS/MP 4. IB maps the Engineering-style keyboard so it is identical to Sun's Type- 
3 keyboard. Applications that expect the Type-3 keyboard, such as editors, will 
recognize the Engineering-style keyboard as a Type-3. 

In the following discussion, "extra keys' ' are defined as those keys that appear on 
an Engineering-style keyboard that do not appear on a Sun Type-3 keyboard. Sup- 
port for the extra keys has changed in OS/MP 4.1B: 

□ The keypost code for the ' 8 ' key on the numeric keypad is now the same as the 
post code for the scroll-lock key. 

a The extra keys are not enabled by default. To enable them, issue an ioctl, as 
described in the kb(4) man page. 

Use of the extra keys by applications is discouraged. Support for them may disap- 
pear in a future release of OS/MP. 



LI -A Key Sequence 



The Ll-A key sequence can be used to force a system to halt via panicQ. Once Ll- 
A is entered and forces a panic the system must be rebooted, it can not be ' 'contin- 
ued" from the ROM> prompt. This key sequence is turned off by default on Kbus 
machines; it is turned on by default on Series S4000 machines. See kbd-abort(l) 
for information on enabling and disabling Ll-A. 
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Serial Port Consoles 



The OS/MP 4. IB kernel allows the display, keyboard, and mouse to be used when 
the normal console is set to a serial port. 

This feature aUows the keyboard and display to be operated as a non-console de- 
vice while still allowing a dumb terminal to be used as the real /dev/console. The 
/dev/fb, /dev/kbd, and /dev/mouse special devices will be automatically mapped 
to the correct display/keyboard group, suntools and XI 1 will function as they nor- 
mally would. 

To enable this feature on a system with an operational graphics display, do the fol- 
lowing steps: 

1 . Edit /etc/ttytab. Copy the line containing console: 

In the copied line, change console to ttycl. 

2. Comment out (add # to the beginning of) the line in /etc/ttytab for the serial 
port, which is either ttya or ttyb depending on the bootROM enviroimient 
variable. See setting the bootROM environment on page 27. 

3. Set the serial port to ttya or ttyb, according to the value used in the previous 
step. For SeriesS, SeriesSE, and Series6 systems use the following conmiand 
for ttya: 

r# ;^?!««i' '^c^aiscffii '[ J 

For ttyb on SeriesS, SeriesSE, and Series6 systems use the following command: 
For Series S4000 systems, use the following commands to set the serial port to ttya: 



1 


eejiroin 


^tW(r$'-T>^VXC^^ty^'' 


i 


'^^piroKi 


' QUTPOT-DEVICEwttya^ 



Substitute ttyb in the above commands to set the serial device to ttyb. 
Enter the command: 

This instructs init to start a getty by sending it a SIGHUP. 

To enable this feature on a system without an operational graphics display: 

1 . Power on the system with the diag switch on (on Series S4(X)0 machines, 
temporarily unplug the keyboard) and a serial terminal hooked to ttya. 
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2. On a Kbus machine enter: 

( ^i^<:^>'jt^"<x?yg03:^^^^^ ^ 

On a Series S4000 machine enter: 






3. Turn the diag switch off (on Series S4000 machines, plug the keyboard back 
in) and enter: 

(^RCM> reset yaxm • ) 

4. Enter: 

(i^o^> i>oot -*-» .r.-.z-^ ...) 

5. Perform steps 1, 2 and 4 from the instructions given above for a system with 
an operational graphics display. 

During the boot up console configuration process, the kernel assigns the /dev/con- 
sole mappings to the serial port, and then scans for any remaining frame buffer/- 
keyboard pairs. If a color frame buffer exists, then that frame buffer and its key- 
board/mouse is assigned to the device /dev/ttycl. TTie devices /dev/fbl, /dev/k- 
bdl, and /dev/mousel refer to this board. Additional color frame buffer boards 
would be assigned to /dev/ttyc2 or /dev/ttyc3. 

On SeriesS, SeriesSE, and Series6 systems, the I/O board contains a bwtwo mono- 
chrome frame buffer and keyboard interface. It is assigned to the next console de- 
vice, either /dev/ttycl, /dev/ttyc2, or/dev/ttyc3, depending upon how many color 
frame buffer devices exist. 

The screenblank(l) command now accepts a -u option for use when a serial port 
is used as the console, or when two graphics displays are in use. The argument to 
-u indicates the unit number (1-3) of the display to be blanked. 

With this configuration, Solboume supports running a windowing system, either 
SunView or X. If started from a normal login running on /dev/ttycl, then the com- 
mand suntools is all that is required, since the alternate kbd and mouse devices al- 
low the kernel to reopen the correct kbdl and mouse 1 devices. A console window 
can be invoked, and any output to /dev/ttycl will appear in this window. The /dev/- 
console always refers to the serial port. 
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Multiple-Display Consoles 



If more than one frame buffer exists, the OS/MP adjacentscreens(l) utihty is sup- 
ported. For instance, the following commands would start SunTools and extend the 
windowing system to the second frame buffer: 



To connect the displays, use the following command: 



D 



When using the X Window System, multiple displays are automatically connected 
by the X server. 



Setting the BootROM 
Environment 



BootROM environment variables that describe devices have the syntax: 

Empty parentheses or empty fields („) default to 0. protocol is required for SCSI 
devices and Ethernet devices. 

□ The disk unit number corresponds to the disk's SCSI address, devid describes 
partitions for disks (0 to 7 corresponding to partition a to h) 

n Tape unit numbers are determined by adding 4 to the number in the /dev entry. 
In other words, the unit number for stO is 4, and stl is 5. The tape devid is the 
file on tape (the first file being number 0). 

□ Ethernet unit should always be 0. The devid is the IP host number of the system 
being contacted. On Series S4000 machines with an SBus Ethernet controller, 
the ctlr field should contain the slot number of the controller. The controller on 
the motherboard is represented by a value of 0. 
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The bootROM environment variables listed in Table 9 must be set. The values 
shown in the table are correct for using sdO (with the I/O ASIC controller) as the 
boot disk and using a frame buffer. 



Table 9. BootROM Environment Variables 



Variables 


Value 


Meaning 


DEFAULTROOT 


sd.siO 
sd.sv(2,l) 


root filesystem disk and partition 
BoSS example 


DEFAULTSWAP 


sd.si(„l) 
sd.sv(2,3,6) 


swap disk and partition 
BoSS example 


DEFAULTDUMP 


sd.si(„l) 


kernel dump device 


DEFAULTBOOT 


vmunix 


kernel to boot 


DIAGBOOT 


sd.si(„6)kvm/st 
and/dg 


diagnostic to boot when in diag 
mode 


BOOTMODE 


manual 


automatic reboot of 


INSTALLED 


Oorl 


1 = mandatory files already 
installed 


NOSPINNER 


Oorl 


1 = suppress "N pages left" in 
dumps, savecore 


INPUT-DEVICE 


keyboard, ttya, 
ttyb 


console input (Series S4000 only) 


OUTPUT-DEVICE 


screen, ttya, 
ttyb 


console output (Series S4000 
only) 


CONSOLE 


bwO.cgO.zsO, 
orfbO 


monitor type (Series 5, 5E, or 6 
only) 



For Series S4000, set INPUT-DEVICE and OUTPUT-DEVICE; for SeriesS, Sc- 
riesSE, and Series6 set CONSOLE instead. 



To print the bootROM environment, use the command: 



(^R<M> pttin.teft'y 



The command to set a bootROM environment variable is: 



3 



(^RaM> J8et,env yajgiaJbl^g yalufe 



There is a space (not an equal sign) between variable and value. 

For Series S4000, begin by setting the INPUT-DEVICE variable. For example: 



D 



(^WH>''mtiim''iJQ^^ 



J 
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This sets the console input to the keyboard on a Series S4000. 

If OUTPUT-DEVICE is set to ' 'screen* ' , the last frame buffer found in the system 
will be used as the output device. If frame buffers are installed in Sbus slot 1 and 
Sbus slot 3, the console output would be displayed on the frame buffer in Sbus slot 
3. Normally the Sbus slots are probed in numerical order (where slot 1 is the nearest 
to the power supply). This default probe order can be changed by setting the 
bootROM environment variable SBUS-PROBE-LIST. By setting SBUS- 
PROBE-LIST to ' '23 r ' , the console output would be displayed on the fr-ame 
bufferin Sbus slot 1. 

While the DEFAULTDUMP variable is normally set to a disk device, it can be set 
instead to a tape device, for example "st.si(,4,)". This is primarily intended for cre- 
ating a tape to send to Solboume for investigating a crash. Customers wishing to 
examine this tape themselves can read the contents of the tape with the dd com- 
mand. An input block size of 8k must be specified, for example: 



('# <jd ±£ntf^L&v/r^tt^ o£»goac^ il>g*tt$k 



ID 



After changing the bootROM environment, the bootROM must be reset to make 
the changes take effect: 



(^"rom>' i^^t: i»a«a 



Using reset warm forces reinitialization of the system. If reset cold is used, the 
Solboume system comes up just as it does from a power-up start. 

Table 10 describes some examples of boot devices. 

Table 10. Examples of Boot Disk Devices 



3 



value 


partition/file 


description 


sd.siO 


a 


SCSI disk (sdO) 


sd.si(„6) 


g 


SCSI disk O(sdO) 


sd.si(,l.) 


a 


SCSI disk 1 (sdl) 


xd(.3,) 


a 


IPI/SMD disk3 (xd3) 


st.si(,4,) 





SCSI tape (stO) 


st.si(,5,l) 


1 


SCSI tape 1 (stl) 


sd.sv(2,3,6) 


6 


SCSI disk 3 on BoSS 
controller 2 



The usage fonnat for SCSI disks is as foUows: 
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For example, the command to set the DEFAULTROOT unit to SCSI disk 1 and the 
partition to a (* * sd 1 a " , in Unix tenns) follows : 

For IPI and SMD disks, use the following command syntax: 

The controller value should be if there is only a single controller. The default root 
and default swap must use controller and unit 0-3 to boot properly with generic 
kernels. 

There was a bug in 4.0D and older releases of OS/MP that prevented running SC- 
Slbus at full speed, even though it printed out the full speed transfer rate of 5Mb/- 
sec. With this bug fix some sites with long SCSI bus cables have experienced SC- 
Slbus timeouts. 

These SCSIbus timeouts are the cause of occasional OS/MP installation failure due 
to the failure of extracting files from an Exabyte. 

A ROM environment variable has been added that allows the "slowing down" of 
the SCSI bus by limiting the maximum synchronous transfer rate that will be ne- 
gotiated. The 5Mb/sec transfer rate results in 200ns/byte. Setting the ROM envi- 
ronmental SI_NSPERB YTE to 300 will slow down the transfer rate to a maximum 
transfer rate of 3.33Mb/sec 

('iW>'''^«tftftv ' '^si^ ' • '^ 
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OS/MP Bugs Open at OS/MP 4. IB 



The bugs are listed in categories, and include the bug ID and a synopsis of the bug. 
The following categories are included: 

O File System 

D Kernel 

□ Networic 
a Utility 

□ User 

n Diagnostics 

□ Other OS 

n Documentation 

n Ongoing Software Dependencies 

n Sunbug 



File System 



B9 106 12003 5/24 tape: tfs filesystem operations report error, but succeed 
B92092 1003 fsck doesn't find all dirty filesystems on first pass 



Kernel 



B9 10508320 "-target sun4" should be set in GENERIC conf s makeoptions 

B910508333 would like to know which simm is bad (S4000) 

B910703002 RFS doesn't seem to come down correctly when rebooting 

B910718010 Panic using Channel Board due to Memory timeout error 

B91 101703 1 would like to add ipi drives dynamically (Kbus) 

B91 1002002 kernel doesn't correctly note available memory (S4000) 

B91 1 106002 maxusers greater than 24 will cause system to reset due to double 

trap (S4000) 
B920401 002 cannot configure a kernel without IPC options (Kbus) 
B920401003 cannot configure a kernel without pty, ether, ei 
B9209 14009 message requested when kmap_aUoc faUs below kmap_lowat 

(S4000) 
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Network 



B92 1010001 kmem_free: block already free panic running net_tests 

B920825006 fsck hangs systems with >5 CPUs installed (Kbus) 

B920914006 CDROM on BoSS hangs SCSI bus 

B91 1 101004 many useless vmunix keyboard errors at 4.1 A. 1 

B920925003 eiO: eiread: mbuf allocation failure on low end SeriesS 

B92 1022003 low-memory system starves processes 

B920728001 floppy activity with mouse activity causes zs2 sUo overflow 



B91071801 1 spray -1 2000 can hang a system's network activity 
B91 1204018 Pipe writes block differendy than under SunOS 4. l.[12] 
B920403007 spray statistics go negative for extreme traffic 



Utility 



B9 10430006 term isn't correct if console defaults to ttya (S4000) 

B91050828 1 initial dopackage prompt confusing 

B910508285 12/14 tape: timezone paths can contain 

B910508293 12/18: error installing X when man pages don't exist 

B910508296 12/18 tape: inst_sys doesn't allow for gateways 

B910508297 12/18 tape: config_system doesn't allow for gateway 

B9 1 0508322 1/23 tape: /etc/mtab is world-writable 

B9 10508325 automounter shouldn' t start if not a network system 

B9 1 050833 1 dopackage reports bad tape format when tape busy 

B910508335 Can't switch partitions in file sys def menu 

B9 1 0508345 config_server ungracefiil about perm denied 

B910508346 config_server tape usage inefficient 

B910508362 tools for monitoring per-cpu stats 

B9 10508390 inst-sys will dump core from this input: 

B9 10508391 make dopackage more robust in accepting responses 

B910508401 at menu not all dopackage variables get changed 

B910508429 dopackage does not update its list of variables after abort 

B910508452 soft links are not created during installation (S4000) 

B910508453 /etc/hosts is not updated on dataless client 

B9 1 05 1 0208 install enhancement for handling patches 

B9 105 1 3003 Script when you first boot should allow selection of interface 

B9105 17002 upgrade of Kbus clients fails if config_servers used -n 

B910614003 Rebooting on ramdisk doesn't work properly Kbus) 

B91 1 101001 quota is not updated dynamically .rclocal entry doesn't work 

B920714010 partition tool doesn't do anything with new mount points 

B9207 1 600 1 cannot install a Solboume client from CDROM 

B9207 1 6004 Install tries to newfs length partitions 

B920825009 More templates arc listed than can fit in the given space 

B9209 10002 config_server - it is desirable not to have /etc/exports modified; 

B920910003 update_exports - doesn't process /etc/exports lines that exceed 
512 characters; 
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User 



B920910004 dis -F does not woric 

B920910007 newfsing of all partitions should be done in parallel 

B92 1008004 can't install hsNFS on Series6 4. lb machine 

B92 1019002 /usr/Iib/libbsdmalloc.a missing from 4. IB 

B92 1 103005 /etc/rclocal assumes network, sunview installed 

B92 1 105001 /etc/hosmame.eiO is not updated on dataless clients 

B92 1 106002 config_system doesn't get default netmask ftx)m inst_sys 

B910508453 /etc/hosts is not included on dataless client 

B910510016 Dis(l)'s usage message refers to itself as "kdis 



B920904002 corrupted screen images with screendump/screenload (Kbus) 
B920630005 no man page for the /usr/etc/scsistat man page 
B 92 1 02800 1 mounting some cdrom is incompatible with Sun 



Diagnostics 



B920526004 Adding more than 256M on SeriesS boards causes misalignment 

panics 
B9208 14008 Disk write/read test fails when prompted (kbus) 



Other OS 



Documentation 



B910912008 partition does not see changes to label until reboot 
B91 1017013 cannot close net. interface with ifconfig 
B91 1 128004 mon/keyboard.h missing 



B9206 1 8002 device drivers man. incorrect about vme32 master to kbus 

transactions 

B910510023 no man page for life(6) 

B910508428 mt ret of exabytes do not work 

B9 1 05 1 1 69 iostat output display is difficult to interpret 

B910508458 the eeprom man page should describe defaultdump 

B910508457 eeprom man page shouldn't mention CONSOLE variable 

B9 10508455 sd man page should describe scsi disk cmd optimization 



Ongoing Software 
Dependencies 



B9 1 0508274 All Utility: Need to add additional terminal support 
B910819005 All OS: LIA doesn't act correcUy for the FRANCE Keyboard 
B911021013 All Utility: dopackage on a tvi925 generates an unreadable display 
B92022 1002 All Sunbug: automounter may spew lots of pathokQ error 

messages; refer to Sim bug id 1080368 
B920320002 All OS : audible bell doesn't woric without windowing system 
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B91 1002004 Kbus Compilers: Solboume is not defined when using the 

System V cx)mpiler 
B910508315 All Utility: boot and opt software tape types must be the same 
B920624001 All Utility: hp262 1 console not supported in partition tool 
B9208 13001 S4000 OS: small-memory system wedges under moderate stress 
B920513004 Kbus OS: eeprom -p option not always recognized 

Any application which statically links an old Ubsunwindow binary, or any applica- 
tion which does not use libsunwindow tp properly lock things, wiU not woiic cor- 
rectly. This is true for Sun systems as well as Solboume systems. 



Sunbug 



B910508294 12/18 tape: cannot restore from floppy (S4000) 

B910508279 bar doesn't teU you if the file doesn't exist 

B910508295 aioread doesn't return EINVAL when it should 

B910508354 malloc (4294967295) returns a valis pointer 

B910508355 callocQ can dump core 

B910508292 tlfs credential failure ->kemel printf 

B9105 1 6004 suntools files in /usr/Iib 

B9105 1 6001 various symbolic links in /usr/bin to sunview/.. . 

B910508283 no man page for uutry 

B910508319 sga20: shadows not refreshed correctly (S4000) 

B910508324 ctags dumps core 

B910509003 RFS can panic RFS servers or clients at the drop of a hat 

B910617005 bug in /usr/lib/acct/dodisk 

B91 1022001 sendmail can break when /var/spool/mail is a link and the 

automounter is in use 

B91 1204007 4. 1 man pages from Sun came with older dates than 4.0 man pages 

B920130015 uniq command bus error core dump 

B920205017 using more causes screen to go blank (csh bug) 

B9203 1 8002 bug in make 

B9204 14002 named complains about bad xfer when set up as a secondary 

nameserver 

B920529004 /tmp/tty.txt.pid files created by cmdtool are not deleted 

B920601002 3rd party software which uses 'delay' fimction will not work 

B920708004 request that tip does ioctl call to save window settings 

B920225005 using quoted :e fimction in vi causes segmentation violation 

B920 1 3 1004 cannot build valid kernel for diskless cHent 

B921013005 man pages for pstat do not explain die fields displayed with -u 

option 

B92 1 1 0600 1 mpstat seems to report cpuO data in the average column (Kbus) 

B920710002 ejecting CD while HSFS disc moimted may cause "seg_release 

addr" panic 

B920831001 in.rsh hangs closing stdin and stdout 

B921 1 12002 problem with curses redrawing the screen unnecessarily 
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B92 111 6001 lint libraries are missing elementary function 

B9 10508307 trace doesn't like having stderr clode on it 

B910508308 should /etc/motd be world writable? 

B9 10508372 connect(2) security bug 

B9 10508399 attempting to mount swap space hangs machine 

B910508450 Sun NFS bug causes failure of SI test 

B910510080 ptyfix 

B9105 10085 B, O, X, and Z constants used only in DATA statements 

B9105 10097 selection_svc and rpc can be sued to gain access to system files 

B910510098 file corruption, inode or vnode pointing to wrong file 

B910510108 strcmp erroneously reads beyond the end of the string 

B910513004 security bug: processes do not disassociate from ptys when user 

logs out 

B91 1001002 you can write to a cdrom, creating a bad inode 

B920708004 request that tip does iocti call to save window settings 

B910508470 SGA20: clipping can cause seg_fault (S4000) 

B910508471 SGA20: moving mouse off-screen during resizes loses (S4000) 

B910510038 error message - "loking for internet address for..." 

B9 105 10040 cpp mis-identifies itself 

B910510041 cron queedefs file is ignored 

B91 05 10042 jobs must ALL complete before newly added jobs will run 

B910510053 directory scan permissions don't work on nfs mounts 

B910510062 make does not expand all dynamic macros properly when 

additional suffixes are declared 

B910510067 caimot create a profiled kernel with config -p 

B91 05 10079 data fault panics 
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Kernel 



OS/MP Bugs Fixed in OS/MP 4.1B 



The bugs are listed in categories, and include the bug ID and a synopsis of the bug. 
The following categories are included: 

n Kernel 
O Network 

a SCSI 

□ Graphics 
n Utility 
O User 

O File System 

□ Library 

D Libsuntool 

a Sunview 

□ Compiler/Loader 

□ C2 

□ Documentation 
n Other OS 

□ Sunbug 

n Diagnostics 

Sun Bugs Fixed in SunOS 4.1.2 

1008324 TIOCCONS is a security hole 

1 1 6767 /boot works for 1 st disk controller only 

1029802 4/280 with xy45 1 panics: regs accessed while busy (patchid 1 00364-01) 

1032053 getreg should use fuwordO when simulating instructions 

1032534 Kernel panics with panic: psig on exiting sunview 

1033861 Request an intelligent swap block freeing algorithm 
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1036 1 67 modified superblock may not be updated at umnount 

1036196 MLOCK/MUNLOCK broken 

1 036449 modified superblock may not be updated at unmount 

1037039 ufs_readdir hangs on a Olen entry 

1037052 shmdt(2) will not detach a read only segment 

1037715 ISO orderly release is not supported, but TCPTLI says so 

1038651 Using tmpfs ie ram /tmp can cause data initlztn w Fortran on 4. 1 

1038686 System panics with "panic: hat_ptesync - invalid pme" message 

1039275 writing to an PROT_READ area is giving SIGBUS not SIGSEGV 

1039287 tcp/tii transport cannot send more than 4052 bytes of data 

1039410 putting default swap partition in fstab causes system crash, dump 

1039840 unmount doesn't close block device 

1039846 unmount leaves metadata cached 

1039850 inode left locked on symlink creation 

1040722 Pseudo-ttys become attached to other users or hang 

1042350 tmpfs problem with ftruncate test in SCTS from SUNVS 

1042808 nopagereclaim erroneously set to 1 for Sim-4/4xx 

1043270 tmpfs disallows mmap beyond end of file 

1043801 panic: assertion failed, pmg->pmg_keepcnt== 1 

1044 192 hard link to a directory succeeds on tmpfs for non-root users 

1044666 panic: ttcompat: unexpected ioctl acknowledgment 

1044668 umount/sync race can hang system 

1044888 Streams run out of dblks and hung the system 

1045360 spurious VME intrrpts cause kernel to panic: data f 

1045582 Newsprint 1 .0 hangs on 4/75 and 4/40 

1046449 multiple-register sbus cards don't work on a 4/75 

1047295 mounting certain iso 9660 cd's succeed but directory becomes data 

1047355 polling not working correctly 

1 0475 86 mkfifo does not work on tmpfs 

1048 128 xon flow control problems on serial i/o 

1049010 DLS60 kernel config file is incorrect. 

1049027 tmpfs hangs and deadlocks 

1049 125 System panic's when reject a network connection via TLI 

1050340 mmap(MAP_PRIVATE), madvise(MADV_SEQUENTAIL)=>panic: 

swap_xlate 

1050540 mount and sync can deadlock and hang the box 

1050543 umount can cause a inactive panic 

1050546 putpage can hang the box 

1 050548 nfs_putpage can hang the box 

1050558 Sparcstation 2 running SunOS 4. 1 . 1 crashes under some applications 

1051875 mkfs can create an unusable file system 

1 05 1 876 system hangs when pageout sleeps in ufs_putpage 

1051983 buffer cache sz decreases w Ig kernels causing high (patch 100330-02) 

1051992 pageout and clustering are not cooperating 

1052649 write system call is returning EINTR 
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1052669 panic: data fault in strwrite - streams corruption 

1053582 mount/sync window causes panic: sleep 

1054054 +s and +t together do not work as expected 

1054999 syncip overhead in ufs_inactive causes poor NFS performance 

1056058 panic when writing to a >=2g-bsize file 

1056245 Process hangs in page_cv_wait, ufs_getpage after locking page 

1056992 4.1.1 leaks kemelmap 

1056992 4.1.1 leaks kemelmap (patch 100330-02) 

10572 1 1 VME master bus accesses can time out during heavy I/O 

1057478 access to non-existn mmap /dev/sbus/ cause panic: async memory err 

1057481 System hangs when running TLI 

1057929 sys hang: prestosrve and NC400 exhausting kemelmap 

(patch 100330-02) 

1057963 cannot mount an exported tmpfs directory 

1060281 polio sys call gives bad returns for f d events 

1061 174 poll does not retum -1 when it receives a signal 

10633 10 floppy driver reports drive as "unexpectedly busy" 

1065858 Can't run OW xinit on 4/670, 4/630 running 412A1.2 

1 066086 4.1.2 kernel crashes under async I/O load, running MP 

1066422 performance enhancements for the sun4m IPI driver 

1 066743 Track crosscall stats separately from intrrpt stats 

1067681 lockf s signal behavior may break applications 

106805 1 profiling kemel support for sun4m 

1068283 vms tat reports incorrect number 

1068363 system crashes with 1 12mb memory and 128 maxusers 

1 068462 kemel workaround needed for bugid 1 0677 19 

1068548 PROM mailbox not properly mapped 

1068907 remote CDROM driver debug info 

1068910 Dump of data using / dev/ sbus * device files broken 

1069072 Int div on spare can be used to modify data 

1 070099 support for removable disks got busted in 4. 1 . 1 



Solbourne Bugs Fixed in OS/MP 4.1B 

B9 1 0508 1 22 1 2/1 8 tape: kemel loses key-up events 

B910508 123 12/18 tape: kemel confiised by mouse & xtool 

B910508303 system with cg30 card reports no keyboard on io-board 

B91071601 1 SunOS Ipd vubierabUity 

B910806002 incorrect memory attributes in software ptes can hang system 

(S4000) 
B9 1 08 140 1 7 preprocessor symbol needs to be defined to be compatible with 

sun (Kbus) 
B91 09 1 8002 Should apply Sun integer division security patch 
B91 1023002 format does not look beyond sd6 in its search_path...(Kbus) 
B920206001 No timestamp in dmesg 
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B920213008 DKIOCGGEOM and DKIOCGAPART iocU caUs give info on a 

non-existent fd device (S4000) 

B9203 1 1005 lock timeout panic when mux and ipi are used together on vme 

B920401004 cannot configure a kernel without NFS support 

B920401006 dk_busy variable overrun with 64 configured disks 

B920522003 memory addr alignment panic running multiple nfs benchmarks 

B92061 1002 iostat does not see CDROM or FLOPPY disks 

B920904003 Sun patch 100397-02 

B920130012 divide by zero test program yields unpredicyable results 

B920406004 request for Sun patvh 100303-02 

B920804004 assertion failed: pp->p_vnode ==NULL, file: 

../..A'in/vm_pvn.c,line:25 

B920827003 Sun patch 100173-08 that has CERT files 

B92091 1001 usnlib Makefile doesn't install libr pcsvc subdir 

B920928002 data fault panic in Idtennsrv 

B921002001 iostat ouput broken in 4. 1 A.l and 4. 1 A.3 

B91 1 126002 unable to take machine to monitor mode from ascii console using 

break 

B92 1 02002 lock violation panic after trying to reacquire mbuf lock 

B92 1005002 very large nfs read request can hang server 

B921 1 16003 request for Sun patch 100075-09 



Network 



Sun Bugs Fixed in SunOS 4.1.2 

1 006905 add lock file to render rpc.yppasswdd s 1 ngle threaded 

1034328 chent can crash if two procs unlink (patchid 100173-06) 

1038060 ieO: WARNING: if_snd full error still noted 

1039326 vmunix : ieO : lost interrupt : resetting 

1041303 ifconOoffbyone 

1 0452 1 1 Problem with booting diskless clients 

1045531 Lock Mgr. suspends "file locking" processes indefinitely 

1045536 nfs exprts to non-sun sys can result (patchid 100173-06) 

1064433 Export of subtree doesn't work (patchid 100173-06) 

1066287 nfs hang when looking at Ig file changed on server (patchid 1 00173-06) 

1066663 SIGIO signal for async io fails to pend across NFS (patchid 100357-01 ) 

1029628 setuid bit copied to NFS file system 

1030884 NFS fiill file sys gets ENOSPC even when overwriting existing file 

1034328 client can crash if two proc's unlink the same file at once 

1034750 automount hangs while trying to open a mount point 

1 037476 Sending bad proc to NFS server can cause mbuf leak 

1038302 NFS export option "anon=-l" does not work 

1038308 4.1 automount sets up a different sym link 5 mins after 1st access 

1039406 3960-3980th repeated sckt open & close tails w addr already in use 

1039839 nres_gethostbyaddr logs erroneous messages to NIS server' s console 

1039977 bug in the NFS DEBUG code, file nfs_export.c 
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1041409 cannot execute sctuid root programs in NFS mounted filesystem 

1041559 system is panicing in mclput 

1042435 client side noninterruptible hang 

1043343 increase arp table size 

1044565 pc-nfs client failed locking entire UNIX file 

1045536 NFS exports to non-sun systems can result in file truncation 

1045700 lockf fails when two processes try to read, write simultaneously 

1045993 NFS file caching still occurring on locked files 

1045995 unlink(2) on a file wiU prevent NFS file locks on the same file 

1045996 File locks are not removed on the server when a client is rebooted 
1046001 fcntl is interrupted by signals and returns the wrong error code 
1046945 'ping' caused machine to panic 

1047557 Old pages not being purged if file gets truncated on server 

1048875 Missing /etc/mtab file can foric the automounter 

1052330 locking on NFS file doesn't cause cache purged after the 1st time 

1052879 panic iesynccmd with SunNet OSI 7.0 

1053552 ip_input drops pckts w IP opts as bad checksum w mclput pnc patch 

1053679 file region locking of NFS files was broken in 4.x 

1054669 telnetd allows password snooping 

1057673 panic: inactive may result from klm code 

1057685 4.1.1 NFS servers freezing 

1057878 panic due to window in rtfreeO 

Solbourne Bugs Fixed in OS/MP 4.1B 

3910508400 OS/MP - starting OpenWindows causes a portmap error message; 

B910828012 rpclockd fails on nfs loopback mounts 

B9208250 1 panic on boot with FDDI and some combinations of other devices 

B9200422002 fddi: pg driver: undesirable connection message wrong. A->D 



SCSI 



Sun Bugs Fixed in Sun OS 4.1.2 

1036481 bsr after reading EOF doesn't record space back, wrong pstn stat 

1042822 St: warning tape may be wearing.... on Exabytes 

1045071 sd: does not scan past 1 GB when using format utility 

1 045586 Handling of special FORMAT command is broken w.r.t blkno decode 

1046305 some XXgetcap cases reversed 

1046580 bug in esp host adapter can cause panic during error recovery 

1048141 esp does not always recognize a marginal SCSI bus 

1 0494 1 7 select phase not timed out causing indefinite hangs 

1049674 general bug report for some esp problems 

1049830 timeouts in polled mode cause a panic 

1050067 esp driver resource aUoc fails when esp is child if dma 

1051244 SCSI Tape drive is misusing signals 

1052613 max dma limits set by host adapters are too small 
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1052659 FSR on the old SCSI tape driver fails in 4. 1 . 1 

1052888 St driver can cause a panic: zero divide trap 

1 055 1 84 3/2 sundev/sd.c uses only one buffer per unit 

1058682 Reassign block (format "repair") malfunctions beyond 1 GB 

1059 1 39 Accessing a SCSI tape drive causes system crash 

1062430 St drvr writes extra file mrics if opened then closed after writing 

1065300 front load tape doesn't reliably read tapes 

1067300 St: soft errors sometimes cause loss of data 

1070535 esp: sync xfer rate is not renegotiated 

1070540 esp: incomplt cleanup after proxy msg causes panic 

1070876 delay after scsi bus reset required 

[various] improvements in st ioctl, EOF, EOT, EOM handling & status rprt 



Graphics 



Sun Bugs Fixed in Sun OS 4.1.2 

1045577 rasfilter_rgtobgr always fails 

1046046 The colormap is not correct when 128 colors are used on 4. 1 . 1 

1046327 P4 CG6 hardware cursor invisible under Sunwindows on 4. 1 . 1 

1063738 Diffuse positional hghts on color-per-vertex tri 

1 063743 Ambient positional lights for color-per-vertex 

1064295 Degenerate hollow triangles cause internal edge 

1066677 GT crashes w SunPHIGS Quick Update of batched polyl 

1066772 wide patterned polylines without nvertex colours 

1066851 gtconfig -M flag doesn't preserve VIDEO_ENABLE 

1066983 quick check pgm to visually test accel port to dev 

1067972 hi res version of cgl2 (gsxr) text is trash in pr_b 

1068136 gtconfig needs sync generator setup pgms for NTSC 

1068 1 53 Leaf nodes which set no attributes cause QUM mode 

1068802 pixwin double buffer bug for GS 

1069396 gtconfig: sync generator pgm change needed for 

1069691 phigschild crashes GT system when huge application 

1070466 Setting hatch_transparency to false affects perf 

1071971 Get jitter when using 1280 @ 67hz video output format 



Utility 



Sun Bugs Fixed in Sun OS 4.1.2 

1 1 6437 Ipd does not check file names for legality 

1022363 format: remove dummy defect list commit for embedded SCSI disks 

1025250 Zero-length defect list causes format to fail ectractn of mnfc... 

1030087 sendmail yp aliasing does not work with non-sun yp masters 

1031577 modload does not recognize the "vector" keyword 

1035625 not cnouglvinformaiion on embedded scsi defect lists 

1036159 A user can run programs with root's group privileges... 
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1 03922 1 bar core dumps w -x or -t option 

1045 1 85 Disks are displayed in controller order but chosen in disk order 

1045636 4. 1 /bin/mail problem delivering mail 

1047340 /bin/mail can be used to invoke a root shell 

1049010 DLS60 config file does not work 

1050675 Original, extract format command fails if defect count is zero 

1051638 format mode selects don't support SCSI-2 page format 

1052805 Low-level format of MD21 disks usually fail with Warning... 

1053733 pax gets into infinite loop at EOT 

1055402 Bourne shell scripts using inline redirection and 

1058003 When reading from /dev/printer Ipd does not check how much data it 

has read 

1058236 checksum error even with -c -i options 

1059212 Improvement needed in mode select error handling for SCSi disks 

1059225 Do not hardwire any SCSI disk mode select parameters 

1063772 possible to overwrite a file on system using Ipr 

1067216 Format fails on 207mb maxtor drive 

1068402 mkfs should initialize UFS clean flag 

1068640 formatting CDC drives generates errors 



Solbourne Bugs Fixed in OS/MP 4.1B 



"a" was a partition 



B910730001 "c" partition doesn't get newfs'd if ' 

B910614002 attempting to examine pcb with crash(8) causes core dump 

B910724014 nstall only shows first nine disks 

B91 1212001 dopackage from disk has to have absolute paths 

B92072 1 005 inst_sys dumps core if user enters ? for help 

B9209 10001 config_server - doesn't understand non-standard tape devices 

B9 1 050826 1 2/1 1 tape: mstat prints incorrect interrupt count 

B910508326 can select "c" partition with other partitions mounted 

B910508339 2/5 tape: garbled screen in partition tool 

B910508340 2/5 tape: unable to read tape after restarting inst_sys 

B910508357 the install_client doesn't update /etc/exports correctiy 

B910508358 tiie install_client doesn't add all tiie entries to /dev 

B910508360 2/11: clients missing sga21 and sga22 devices 

B910508371 install_client fails if exportfs fails 

B91 0508402 dataless clients mount /usr read only 

B9105084 10 3/25 tape: partition tool reads wrong disk label 

B91050841 8 awk and In are missing from ramdisk 

B910508435 dopackage may die with non-explanatory error messages 

B910514014 5/13 tape: partition core dumps if have >8 swap partitions 

B910628002 4.1 installation reporting lots of zsO: parity erros, ignored 

B9108 14002 Ipr -s causes >64 spool etries to use unprintable chars in their name 

B9108 19006 installer mishandles "c" partition of disks when other partitions in 

use 

B910827006 installer does not warn about further use of c partition 
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B9 1090901 8 install_client allows client swap sizes less than 8m 

B91091 1009 cannot delete files 

B920408003 pmake can dump core if ti encounters NULL commands 

B920501001 partition tool does not deal with lots of drives 

B920828006 config_server fails in some cases with 4. 1 A.3 cdrom 

B9 10520004 problems arise when restoring a large filesystem on ramdisk 

(S4000) 

B910508310 partition tool foxed by tape drive at disk SCSI ID 

B910508368 satools host tools doesn't work under 4. 1 

B9 10508432 quot(8) -v can dump core 

B910604004 5/24 tape: partition prompt and help don't match for newfs 

B9 106 17007 config may dump core if the iobus phrase is not added correctly 

(Kbus) 

B910709005 cpio dumps core after copying files if fed from text file 

B9 1 07 1 1 00 1 can't dump u-area data when using adb on a kernel core 

B910508286 12/14 tape: bogus remote path info kills ramdisk 

B910903001 function shlistQ loops indefinitely if /etc/sheUs exists 

B9101 10006 traffic reports bogus data with fddi 

B9206 15008 need inst_sys version for multiOuser mode 

B910508288 12/18 tape: 'partition* is ambiguous in inst_sys 

B910508318 need a "load miniusr" command on ramdisk 

B9105 14015 partition(8) says you aren't superusr in demo mode 

B9 10508278 you can boot UNIX before the tape is done rewinding 

B910508289 12/18 tape: error from /etc/rc -uucp -c results in usage message 

B910508387 increase the number of bad block from 126 to correspond to the 

size of the disk 

B9105 10026 uustat does not exist on your system 

B9105 10155 ftp(l) globs its second argument, resulting in a core dump 

B9105 10168 ftp help information refers users to Sim 



User 



Solbourne Bugs Fixed in OS/MP 4.1B 

B91091 1002 umount will not always unmount a device 

B9206 15006 hosts.equiv should not be shipped as it provides full net access 

B920630006 scsi bus resets on tape timeouts 

B910508384 software from ki research dies 

B920701002 format, using file shows wrong drive 

B9108 19005 LiA doesn't act correctiy for the FRANCE keyboard 



File System 



Solbourne Bugs Fixed in OS/MP 4.1B 

B910508440 NFS write errors reproduceable with RepliCORE 
B920206003 filesystem full messages shouldn't flood user's terminal 
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Library 



Sun Bugs Fixed in Sun OS 4.1.2 

1038500 localtime or tzsetwall corrupts malloc space (libc) 

104 1074 The disk version of the "C* locale is incomplete 

1044722 undefined symbol in libxpg.a 

1044909 /usrAib/expreserve race condition was used to break into a system 

104547 1 4. 1 (+) shared C libraries reference undefined symbols 

1 050040 fcvtO segment faults under 4.1.1 

1 05 1 6 19 systemO uses the system call forkQ instead of vfor 

105 1 88 1 coUdef rejects apparently valid input 

1052398 strxfmi is not 8 bit clean 

1 052463 colldef can't handle a substitute statement with hex numbers 

1053346 There shouldn't be an imposed length limit for strings in strcollQ 



Libsuntool 



Sunview 



Sun Bugs Fixed in Sun OS 4.1.2 

1038363 window_destroy does not release memory; 8k memory leak per textsw 

Sun Bugs Fixed in Sun OS 4.12 

1028856 2/2 master defaults database is not being read 

10383 13 1/1 Can't open and use more than 64 windows concurrently 

1039576 1/1 selection_svc and ipc can be used to gain access to system files 

1039760 3/2 notifier fails to handle fcntl for FNDELAY correctly 

1040606 2/3 selection_svc security problem 



Compiler/Loader 



Sun Biigs Fixed in Sun OS 4.1.2 

NOTE: new compiler/loader in SunOS 4.1.2 includes substantial fixes that may af- 
fect some application programs. See "Link-editor Bug Fixes" in Chapter 2 for more 
detail. 

1019004 -assert definitions can fail to report undefined symbols 

1032208 Idd doesn't write file names if standard output is not a tty 

1 032209 Idd runs out of file descriptors 

1032739 Id core dumps with many fibs in mult, directories 

1033086 Calling dlopenQ on a file with BBS kills your application 

1034788 -r and -pic do not mix bad secondary magic number on 4. 1 

1034833 Id: can't mixed -r with -Bstatic or -A flag in 4.1 

1034844 missing symbol from Id -r 4. 1 object; exists in 4.0.3 Id output 

1037879 Cannot create executable w shared obj which points to another 

1 04226 1 Id only recognizes first directory in LD_LIBRARY_PATH 

1043082 Bogus first arg to 'Idconfig* kills dynamic linking 
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C2 



1043300 dlclose prevents access to functions even after fiirther dlopen 

1044524 multiply defined symbols and seg. fault caused by 4.1 's Id 

1045 194 dlsym retums bad addr for uninit global var in dlopened library 

1045272 Id -u & -r don't seem to work properly 

1046379 can't call a fhctn in a shared lib from a fnctn in another... 

1046462 Id fails with seg fault proc nested incl 

1050594 Uninitialized struct slot causes intermittent failures 

1052428 Is.so usage of -L options confusing, leads to security problems 

1064820 Id can produce bogus diags with cascaded 

1069404 bad handle errors with dlsym(dlopen(NULL, l),"xxx") 

Solbourne Bugs Fixed in OS/MP 4.1B 

B91 1002004 Solbourne is not defined when using the System V compiler 

Sun Bugs Fixed in Sun OS 4.1.2 

1040334 yppasswd won't allow user to change passwd from client, .daemon dies 

1040465 The passwd -e command does not work when c2 security is in place 

1044204 rpc.passwdauthd can be used to guess passwords on c2 systems 

1 047 131 getauditflagscharO routine as distrib in 4. 1 libc does not work 



Documentation 



Sun Bugs Fixed in Sun OS 4.1.2 

1 05 1 8 80 colldef input fonn at not documented 

1 05 1 8 82 sem antics of colldef are unclear 

1041627 add_services can fail if partition changes are made after Sunlnstall 

1047095 install from CD stops and complains if floppy is in 

1047696 Can't boot 4. 1 . 1 munix on a sun-4c w/40mb of memory 

1063858 disk form takes 5 minutes to exit in a 40 disk machine 

1064779 dataless install corrupts file system 

1069645 should add support for keytables in munix 



Solbourne Bugs Fixed in OS/MP 4.1B 

B910521005 B910508260 closed by OS but still in 4.1 release notes 

B910510020 ssignal(3) never actually describes gsignal(l) 

B9105 101 15 man page for scandir(3) is wrong 

B9 10806006 remove satools man page or include satools in release 

B920305002 tar -r doesn't work for 8mm either 

B91 1021008 config_server will not install anywhere by /export without editing 

the script 
B91 102 1009 install_client cannot be installed anywhere but /export without 

editing the script 
B920903006 semcdQ man page 
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Other OS 



Solbourne Bugs Fixed in OS/MP 4.1B 

B9 1 05083 85 sundev/mbvar.h references bogus include file 

B910508389 4.1 A (5/2 tape) - S4000 diskless client exception when booted "-a" 

B910822004 The link /usr/lib/rasfilters/convert.3 -> ../../bin/rasfilter_rgbtobgr 

is invalid; 

B92 1028005 fsck on volume fails with error: fsck: can't stat /dev/vol/rvoll 

B910508287 references to Sun in admin files need to be Solbourne 

B910508375 core dumping problem with UUCP 

B910508327 the list of a vnode can become long enough that a panic occurs 

B9208 12002 bsf option of mt command returns i/o error 



Sunbug 



Bugs Fixed in OS/MP 4.1B 

B91 09 12002 pstat -u prints incorrect ru memory numbers 

B920323003 process should not be able to ptrace itself 

B91 1024001 spell ignores custom hashed dictionary 

B91 1 106001 need patch equiv. to Sun Bug ID 1028094/patch 100283-10 

B910508313 Idd dumps core when run on Id. so.cache 

B9 105084 19 if severely abused, ipc.lockd can dump core due to a seg fault 

B9105101251int fails on this program 

B910606001 rpc.lockd gives strange error message when remote host goes 

down 

B91082701 2 cannot write >2. 1GB file to a 5GB Exabyte tape drive 

B910918001 4.1Adopackagewillcrasha4.1.1 Sunwithpsigpanic 

B920428003 Ipstat with list options 

B920707002 you can lock up a system by attempting to connect a socket to itself 

B920722001 need to apply CERT patches for NFS, integer muldiv and ICMP 

redirects 

B9208 17001 request for Sun patch 100606-01 

B9208 17003 request for Sun patch 100482-02 

B920817004 request for Sun patch 100361-04 

B920820002 request for Sun patch 100361-03 

B921028002 Sun patch 100283-03 

B91072301 1 filesystem limited to 2 Gbytes 

B910508363 system hang condition 

B920427005 can only fcntl (,F_SETLK,) or lockf fds associated with vnodes 

B920206004 at now does not work 

B910508282 Ipq +<interval> problem 

B910508290 sendmaiLmx is broken 

B91 0508349 doprint dies due to segmentation fault if "%<n>$" construct used 

B910510047 system panics on swap file created by "mkfile -n" 

B91 1002005 a power cycle or SCSI bus reset will allow the eject button on a 

cdrom drive 
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Diagnostics 



Solbourne Bugs Fixed in OS/MP 4.1B 

B920527001 DG disk faUs on 3Gbyte DPI with 1 K or 2K sectors 
B920527002 Sysdiag disk read test doesn't get run on 3 G DPI with 1 or 2K 

sectors 
B9 1 06 1 9002 Sysdiag core dumps at 4. 1 when running VME/RAM test 
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Patches Included in OS/MP 4. IB 



Sun Patches in OS/MP 
4.1B 



1 00075-09 rpclockd jumbo patch 

1 00 1 03- 1 1 script to change file permissions to a more secure mode 

100170-09 jumbo patch to fix various Id problems 

100173-09 NFS Jumbo Patch 

100178-07 inetd "broken server detection" breaks on fast machines 

100224-03 program "mail" "rmail" problem in delivering mail 

100257-04 jumbo patch for Id.so, Idd, and Idconfig 

100283-03 in.routed mishandles gateways, multiple routes 

100296-04 netgroup exports to world 

100303-02 system freezes using loopback interface 

100338-05 system crashes with assertion failed panic 

100342-03 NIS client needs long recovery time if server reboots 

100359-06 streams jumbo patch 

100371-01 utility;showfli showfh timeouts before accessing nfs filehandle 

100376-04 SPARC:Integer division/multiplication bug 

100377-05 Sendmail.mx doesn't recognize wildcard, forward, uid's > 32767, 

"LD_" environment variables can be exploited tosubvert security 

10038 1-01 du and tar bug fix for compatibility witii VMS 

100383-05 rdist security enhancement 

100407-05 accounting files are corrupted when commands run as nobody 

100408-01 libcurses replacement with all 4. 1 . 1 CTE patches 

1004 14-01 programs using pty get output from previous application 

100425-01 whois gets host unknown when using the hard coded NICHOST 

100482-03 ypserv sends maps to anyone who guesses domainname 

100505-01 Zero length directories can be left on system ( 

1005 1 6-01 increase HEAPB YTES to prevent system hangs 

100520-02 Cron dies when daylight savings time STARTS/STOPS 

100539-01 umount of busy hsfs filesystem causes panic data fault 

100567-04 mfree panic due to mbuf being freed twice, icmp redirects can be 

used to make a host drop connections 

100606-01 ccom More than 15000 symbols causes "out of hash table" 

100630-01 environment variables can be used to exploit login/su 
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10063 1-01 environment variables can be used to exploit login 
100651-01 Cron dumps core & Cron dies when daylight savings time 

STARTS/STOPS 
10073 1-01 kemel/db vendor's use of sticky bit on plain files causes corrupt 

nodes 
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Installing OS/MP 4. IB 
on a Standalone System 



■— UliWiH 



Before Installing... 



Installing... 



The OS/MP 4. IB software tape is a full installation media that allows you to update 
from a previous release, change the size of partitions on the root disk, add a disk to 
a previously diskless system, or configure a standalone. 

A standalone is not a newoiked system. A standalone system does not provide NFS 
disk services to clients. It also does not depend on a server for its root, swap, or 
/usr filesystems. 



• • • CAUnON • • • 

Perform a full backup before installing OS/MP 4.1B. A complete installation 
overwrites all information on the disk partitions specified for the root (/), 
swap, /usr, /var, and /tmp filesystems. 

Before installing the release tape you must clean the tape drive on the host ma- 
chine. Failure to do so may result in damage to the release tape. 



Loading the ramdisk image is your first step. The ramdisk image is a special UNIX 
operating system kemel with a built-in RAM disk that contains the installation soft- 
ware. The command to load the ramdisk depends on the type of system. FoUow the 
instructions for your system type. 



Installing on a SeriesS, 
SeriesSE or Series6: 



Loading the-Ramdisk 

Tum the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 
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Loading the Ramdisk via a Local Tape Drive 

Ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to detennine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 

( JRC?M> aetemr iaa-talXed D ^ 

The system asks if you want to re-install if INSTALLED is not 0. 

The variable Tape ID shown in the commands below should be replaced with the 
SCSI ID of the tape drive to be used. For stO, use 4; for stl, use 5. 

To load the ramdisk on Series5 or 5E systems, enter a boot command of the follow- 
ing form: 

To load the ramdisk on Series6 systems, enter a boot command of the following 
form: 

( ROM> l>oot »fe,glt^y9p>$-J£>^$) ) 

The Series6 bootROM copies the ramdisk image into memory and boots it: 



/§oot : "St : si if 4f 33 



.Size J O0x«a00O+0x43t>8?8^0K3«9^fO 



The system displays spinner while it is copying the ramdisk into memory. When 
the copy completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

Ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 

(^B^>$^^&ty in.^t$tXl^<$-'^ / ' ' '"' ............... .....3 

The system will ask if you want to re-install if INSTALLED is not 0. 
Install the OS/MP 4. IB CD-ROM disk into the CD-ROM drive. 

• ••NOTE*** 

In order to boot from the local CD-ROM disk, the bootROMs must be at version 
3.5 or higher. 
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To load the ramdisk on SeriesS, and SeriesSE systems, using a local CD-ROM 
drive, enter a boot command of the following fonn: 



To load the ramdisk on Series6 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 

( ^ROM> boot ■8-d.:Si(^6^,}/ln.8t:.a3.1,Seri6a€ ^ 

The bootROM copies the ramdisk image into memory and boots it: 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Diskful Installation 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, the system displays a list of supported 
terminals: 

Ay BIO ""' ^ 

2) ^A&L 
2) hp 
4) &WX 

6) vtlOO 

What .t:^P0 Of t$!£Jftirial are you y^ing- {'^l'^,, '^*f^}7 
If you are using a frame-buffer, select the 4, the sun terminal type. 

( Wfaat type of tejaniaaX are yo-u ttslag { ^1*" . .^ ^^^ > 7 4 } 
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If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 






or ^*>^ 



Vo you want to re^^instalX the s:jfatem i "'yes'' f '^no* 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable, as described pre- 
viously. 

If the message appears, enter yes to re-instaU the mandatory system software, or 
no to continue installing software without re-installing mandatory OS/MP. 

The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 



/BArndL^k. 



~^ 



1) Change ^t&k -^axtitioning 
2J. Install Software 

$i Halt $5>si:i$Jtt . 
Sater number o£ ^ftinction to exec ate C*!* 



^5^y -or ^"^^ tar 



The provided functions are described below: 

Change Disk Partitioning - Allows changing the sizes of disk partitions, and 
where those partitions are to be used for, filesystem space, swap space, or unused 
space. Refer to the end of this chapter for details on changing disk partitions. 

• ••NOTE*** 

If changes are going to be made to the disk partitions on which OS/MP 4.1 B will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4. IB can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. 



Installing OS/MP 4. IB on a Standalone System 55 



Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the fonnat(8) command. If they are, you must then 

select Change Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts the UNDC operating system after software installation. Al- 
tematively, you may reload the ramdisk from scratch. 

Halt System - Retums control of the system to the bootROM. 

You can request help at any ramdisk prompt by entering a question mark.Table 1 1 
shows the edit commands available when you are entering text in response to 
prompts: 



Table 11. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete m 


delete last input character 


AU 


erase input line 


AR 


redisplay input line 


AW 


delete input up to 7* or whitespace 


AC 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


AL 


redisplay entire screen 


return (aM) 


end input 


newline (aJ) 


end input 



If a string is too long to be displayed in the available space, the begirming of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 



56 Installing OS/MP 4.1B on a Standalone System 



Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 

^'■^iTj^tity ^aneV ' '^ ' "^ ^^ " '. ^ 

# cd / 

V ^ 

where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Install Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all infonnation has 
been gathered. 

The system uses three informational menus to gather the necessary information: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /imp) are located. 

D Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

O Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to retum to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition Menu defines where the mandatory filesys- 
tems are located. 
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Any changes made to the standard filesystems with the partition tool appear in this 
menu. 

Normally, no changes need to be made at this menu. To proceed to the Media Iden- 
tification Menu, enter 'continue' . 

The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 1, the notation ''(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any partition of any disk. 



r 



Sttanddfd FileSy^t'Sttft I>6f initiou 



1) toot ort ^m^ Cr6<5alr6<i^ 

2) swap an sdQb fretji^ired) 

4) /var on root paartition 
5> /tiftp on root i>Artit5ior> 

Di^Jc Partition? {MrX^^ i^ 1^) 

(a^ (fe) (c) (d) ^e) (f) <0 fh} 

S!?tO; 8.4 Zt^^ X%X.\ $.3 i4J.a 

sdX: 8.4 32*7 1&0*9^ 9^6 *-»*« «■«** 14-&^8 '**>^ 



Ent^r number o£ f ii«ayj&t«ai. to change (■*!*,♦ "^S-* ^ ^ ■*coj:itxnMe*> *^pz«tvioua' , 



Figure 1. Sample Standard Filesystem Definition Menu 
To modify the /var filesystem, enter the number: 4. 

^previous* t ^cancel' or ^1* for beljE>t 4 
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The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 






The new arrangement is displayed as shown in Figure 2. 



r 



1) 
a) 

4) 



s40i 



StHXkdaicd Flimsy ^t«m De£lrtlti<5trii 
S^-i3 32*7 i9a*5 9<6 *-"« +*-*+* 



<0 

140.8 



{^^ 



Ent«3: aijimber of fiiesyat^^gi to change ^^1* .* '^^'Jt ^continT^e^ ,h ^pxevi,oua^ / 



V 



Figure 2. Modified Standard Filesystem Definition Menu 

Once all changes for the standard filesystems have been made, enter continue 
to proceed to die Media Identification Menu. 



Eater sitanber of filaaystem to change { H*" . . ^S*' ): , ' "^contintie' ^ 
^pc«vioT?.$' , ^o^nc^l'jf OPT ^?' for it^ip; iiotttiiiwft 



Installation Media Identification Menu 

The Installation Media Identification menu specifies the location of the media 
which will be used during the installation. On systems other than the Series S4000, 
the default tape is the local, even if no such drive exists. Therefore, changing the 
settings on a non-Series S4000 machines probably will be necessary. 

Figure 3 shows the Installation Media Identification menu of a machine that was 
booted from a local tape device stO (SCSI address 4). 

Installation may take place from Tape or CD-ROM. Each of these installations are 
discussed below. 
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tyi^tallanlo/t fcilisctia Identification. 
5^ I'ap^ host * localhoat <i27*i):.0*l): 



help* 



'<fonti»^«fc* r '|>xeyto'tt^% *<j4tt<!i«ls -Ckr ^?^jfor 



V 



Figure 3. Installation Media Identification Menu - Local Tapehost 
Tflp^ Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to 'local- 
host '. The Installation media type must also be set to 'Tape*. 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 4 shows the Installation media type menu 
with the CD-ROM parameters set to install from CD-ROM. 

When the details of the media have been entered correctly, enter continue. You 
will be presented with the Package Selection Menu. If the operating system has al- 
ready been installed, you will be prompted to insert the optional software distribu- 
tion media. 

Package Selection Menu 

Use the Package Selection Menu to install optional Solboume software distribu- 
tions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 



60 Installing OS/MP 4.1B on a Standalone System 



f Xvt^^^Xl^t^i<oxt l!*944-ft t<!$.^ni;if4.<jati<?» 


SS!-i§5S$:SSi:i;i:j$^^^ 




■ill 


t) X^i^t^lX&H^iOfi imti^i& t^p^ * C:0~^OK 




8 






illllli: 


; 21 CQ drive « /<JeV/6i:0 


3t« tape) 






liliiii 






llllli 






Ijlljj 








jlljl 






llllli 


i 






Hi 






illllli 


' 






llll 






:^ ■" '. 






^io-SiiiSiiSiS 






^ 






Bll 








^ 'CfgW1l<?6-l' 


4 a» 


^^/tor 


V 






liliiii 






J 



Figure 4. Installation Media Identification Menu - Local CD-ROM 

related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solboume OS/MP Optional Software, is included on the OS/MP 
4. IB distribution tape. The following display shown in Figure 5 appears; the values 
shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 



/£:iter Rt»Hber of 'package -to «ixamine {^1' ♦* '*l').r -^Gancel'/"^ 
f *ia$tall' , oh ^7/ for h^lpt 1 

StiOulti t3l$t ^6lJ:H>-u.rfte <X$/W^ 4, IB Optional $oft;waitr^ p$itikA<^^ 
she iTiflftaXled i^y^i^* f ^no^, ^C^ or *?' for help)? yea 
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ERii«!i- rtiJjflber o;f Jj^dGkig-^ to examine C*i'**^i'>^h *6anpei' ^ ^indtall'^^ " oi" *^* 



V 



_y 



Figure 5. Package Selection Menu 

The Should the Solbourne OS/MP 4. IB Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu appears as shown in Figure 6. 

• ••NOTE*** 

Figure 6 is only an example. The Free KB reported varies depending on the type 
and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule 's name. The column after the size indicates whether or not the module is cur- 
rentiy marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING - program debugging aids 

This module contains tiie debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 



62 Installing OS/MP 4.1B on a Standalone System 



<i«9tomi«»tion oj? $io3-i>otta:«« 05^/«^ i*lt 0p%ion^% ^it-it^x^^ 



9> SYSTEH V 
111 VSRSATSC 



2872 

5^152 
4$ 



last-all jyiic&xit^xf 



y 

y 
y 

y 
r 

y 
y 

y 
y 



/usr 



Fr-6e (KB) 

586915 
5865S 

58695 
5S690 
5863S 

586^5 

56695 

5$$95 
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Figure 6. Package Selection Customization Menu 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer' s Manuals in machine- 
readable fonn. Seeinan(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
S/YP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 

SECURITY -C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The comphance of these features has not been certified. 

S V_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires tiiat SV_USER also be installed. 
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SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSDC, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, i.e. vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

to other UNIX systems via phone line. 

RES 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be mstalled and, if so, 
the directory its files are to be extracted into. 

• ••NOTE*** 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter numbet: ot modtile to- modify ( ^1^ . , "^IB* ) ^ '»ciaatimi«' ^ 
^^nhoxf^ , or ^7* for It^iy? X3, 

The VERSATEC menu entry is highlighted, and: 

x^if ying t-li^ v$rs$.te.a: j^riaate-ir ^uppoti; ffio<Sule 
vor ^?*' £fit ii^lp)? no- 
Figure 7 shows the updated display: 
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Figure 7. Package Selection Menu - Deletion of Versatec Module 

• • * NOTE • • • 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 7. 

To install the GAMES module in /fun (on the root partition): 



Eatar ntaaiiber o£' module to miadify Oi* *.'^13n# ^oontinue'^ 
^^fciorfc''* OE *^' -foe- 1i»lp; t 



The GAMES menu entry is highlighted, and 

/So^ifyitigr fhe gaiaea ajj-d demoHStratlon procframs module ^ 

Should tlse tJAMBS module be installed {^yes'r ^noS "^C^ or 
*?' foj? help)? y^is 

Ift^t-all (5-AME^ itt What; <4il:^<JtCJ£5^? /ftm 

/fua does not exist. Cxea-te it during installation C^yais*'^ 

The menu is updated to reflect the change, as shown in Figure 8. 

• ••NOTE*** 

The free space for /usr changes, and a completely new size (for /funj is also dis- 
played as shown in Figure 8. 
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Figure 8. Package Selection Menu - Install Games Module to /fun 

If you decide to discard all changes made to the modules, use the command 
'abort '. This returns to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand 'continue*. This will record the changes and return to the Package Selec- 
tion Menu. 

When you have completed package customization, (which may mean you didn't 
select any packages for installation), enter 'install' as shown in Figure 9. 

The actual installation begins at this point, and may require 10 minutes to one hour 
depending on how much software is being installed. 

The steps taken during the installation are: 

1. extract miniusr. (This contains the installation software, as well as enabling 
swapping) 

2. create filesystems (root(/), /usr, or /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. create device entries 

4. install mandatory root files 

5. install mandatory kvm files 

6. install mandatory usr files 
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Figure 9. Package Selection Menu 
7. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 10). If 
the installation failed, caU Customer Support. 

Rebooting from the Ramdisk 

After a successful installation, start UNIX by rebooting as shown in Figure 1 1 . 

Enter number of function to execute (' 1' . . ' 5 ' , or ' ? ' for help) : 4 

At the Reboot System menu select Boot Unix: 
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Figure 10. Ramdisk Menu 
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Figure 11. Reboot System Menu 
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After selecting 1, there is a short pause, and then: 



/:^ift£>3»atic i>aot ^^Jq^:led♦ Type ContE-al-C 't<i> ^ij'ort 



1992 
1 1 ♦ ♦ ♦ i 



At this point, the system configuration information must be specified. 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 






Automatic reboot; in progresis^** 
checking qpot-as: don^* 



Ta,Lt -^y^tr^vk Jia5 not ye^t bei^n confi^xr-edix s:i$v^3:«l va^u^^ 
need t& be -set before the system can c«rae tij^ to multX-^us^ejtt 
tJriix <• 

What *i^ i:hi$ $^yai:^at'^$ ii^na^ {^efiault =» *^tt-aii4ia6ii&* ) ; 

<RetTiaK:»> 

tiifh^t i^ Ifee IjitO^rnet acKlP^^^ <0 foe noft^^ <J^fa3EjJ^t. « 
J255.2SS,2B5.2SS)? <Jtettt«a> y 



• ••NOTE*** 
Using the default 'none' disables the NIS/YP services. 
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Enter time z;<;>rt« (default ^ ^ OS /Mountain' ) t V^ <R^tV£JQ>- 

Alaska ^ Central Hawaii P<^c±ttc 
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Hos-t nazEve 

itatwork jnask 

*Sim.et zone 
»ftt^ {ttt/<;i/y) 



*» at^m-daloae 
*i^ Ox GO 00060 D 
«• (JS/Mountain 
» 16:55 



Arfe- these aorrect (■*yei&'' ot ^liO-* ) ? 

yes 

Setting netmask of eiO to 255*255-255,0 
Setting passwDEd.faF roat 

Chaiigltiij -^aa^vford iSor t:o<i>t on. st^ritiaioiie ♦ 

^ew pa£r8Word: 

l^type r>^«* f>a$8»ordi 

Cantljfttiin^ bot»t : 

pitartiftg rpc Aind-not setrvi<2^$5. ^orti^ap t*- 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) llie system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button.. 

• • • NOTE • • • 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 

If the system booted successfully originally, you may instead log in as root: 

Ci^octei^or^^ login;- *oot ""^ "" ^ 

In either case, if a file exists that tells the system it has been configured, remove it: 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

('#' "^:i,±i ) 

Otherwise, use fastboot: 

The system asks configuration questions just as it did the first time it booted after 
beingjnstalled. 
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Installing on a Series S4000 



Loading the Ramdisk 

Turn the system on. After the system passes the self-tests, the system displays 
bootROM prompt. 

Loading the Local Ramdisk via a Local Tape Drive 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



(K?M> getenv j^nat^lXed 



3 



The system will ask if you want to re-install if INSTALLED is not 0. 

Install the OS/MP 4. IB distribution tape into the tape drive and enter the install 
command. If there is more than one tape drive, the bootROM asks which tape drive 
to use. For example: 

/^OM> install " 

5^hich typQ of «ievic^ da you wish to i»8tal,X -frami 

1) Tape 

Eflt;$i; <i$viC:)$ ti??^: 1 

You have the f&ilo'wiiacf ttape <iEiv"^$* Pl-^ipi^^ choo;^^ one: 

li At ^ajiget4^ d^ive najnes ARCHIVE VXPER ISO 21247-OOS 

2) At tacgetS, dcive name: StXA&yTB £;XB-a200 251^ 
Sinter device Ri»«ber: 31 

The bootROM copies the ramdisk image into memory and boots it: 

Entry r OxfdOSOOOO 

Sizet Oxea00a+0«:43b87g-t055:3a9f0 

The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. 

U)ading the Ranuiisk via a luteal CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 
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The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 



|ipip|pii|i|||^^|p|l^ 



The system will ask if you want to re-instaU if INSTALLED is not 0. 

Install the OS/MP 4. IB CD-ROM disk into the CD-ROM drive. 

To load the ramdisk on S4000 systems, using a local CD-ROM drive, enter a boot 
command of the following form : 

The bootROM copies the ramdisk image into memory and boots it: 

^ ■ 

A spiimer is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Diskful Installation 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a list of supported terminals is displayed 
as follows: 



/H 



2^ ansi 



3) bp 

4) sun 
6} tvi9il2 
^} vtl&O 
1i wys.e50 

^hat type o£ terminal axe you using C^l^ **"*!* ^"i 

If you are using a frame-buffer as the console, select the 4, the sim terminal type. 

(what type of t-exroinal ar^ you uising (^1^ ..^^7*^)? 4 ) 
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If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



/TfHIS SYSTEM IS ALREADY lUSTUhlMn ' ' " 

Do you wa».t to r^~l».stalX the system Py«s', ^>ao'^ or ^7^ 
\ jor helpn ^ 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. 

If the message appears, enter yes to re-install the mandatory system software, or 
no to continue the installation without re-installing it. 

The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 

X) Change Di^k E^attitioilincr 

2) Install Software 

35 Xnvokei a Bourne- Shell 

4) l^boot $y3t«m 

5J Bait Sy$t^n< • 

Eftter ntiml>$tit -at igiiiictiort tO est^outa {^1^ ^ , "^^ t Or- ^?' foir 
M ^elp^ : ^ y 

The provided fiinctions are described below: 

Change Disk Partitioning - Allows changing sizes of disk partitions, and whether 
those partitions are for filesystem space, swap space, or unused space. 

• • • NOTE • • • 

If changes are going to be made to the disk partitions on which OS/MP 4. IB will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4. IB can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
bourne software distribution, such as X Windows. Refer to the section, "Software 
Installation from the Ramdisk," for more information. 
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Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the fonnat(8) command. If they are, you must then 
select 'Change Disk Partitioning' before attempting to 'Install 

Software*. 

Reboot System - Starts UNIX after software installation. Alternatively, you may 
reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 

Help may be requested at any ramdisk prompt by entering a question mark by itself. 
Table 12 shows edit commands available when entering text in response to 
prompts: 



Table 12. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


AU 


erase input line 


^R 


redisplay input line 


AW 


delete input up to 7* or whitespace 


AC 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


AL 


redisplay entire screen 


return C^M) 


end input 


newline (^J) 


end input 



If a string is too long to be displayed in the available space, the begiiming of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co* for 'continue'), ex- 
cept for *yes' and 'no', which must always be spelled out. 
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Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#** 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



# cd / 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Software Installation from the Ramdisk 

Installing software has two distinct stages: gathering infonnation and modifying 
the system. No permanent changes are made to the system until all information has 
been gathered. 

The system uses three informational menus to gather the necessary information: 

□ Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) arc located. 

D Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

□ Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten, 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. 
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Any changes made to the standard filcsystems with the partition tool will appear in 
this menu. 

Normally, no changes need to be made at this menu. To proceed to the Media Iden- 
tification Menu, enter 'continue'. 

Changing an entry at the Standard Filesy stem Definition 

The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 12 shown below, the notation "(required)" appears next to the root(/), 
swap and /usr filesystems. These filesystems must be defined; however, they may 
be placed on any partition of any disk. 

^ ^ ' ^ ^ 

2) swap ot). sdOb (required^ 

4^ /var on root paxtiti<i>n 
$) /tfnp on xoQ% pdjiiitioiii 

Dislt tartitdon^ {^tT.^^ in MB) 

i^\ m (c3 m <e) m (^) (Ji^ 

BdOr 8.4 32,4 191,1 5,3 141-1 

&m.t 8.4 32*7 190.9 S>,€ 140,8 






Figure 12. Sample Standard Filesystem Definition Menu 

To modify the /var filesystem, enter the number 4. 

Enter Huatber of f ileBystfifa. to chan^^e (^1' . , "•$'> ^ ^oontiiiue' 7 
^previous' r ^cancel' or ""It^ tox h'Ql'pi 4 
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The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 



filesystem, ^aone^ "^^t oji:^'!?^" for li«lpi sdOd 



The new arrangement is displayed as shown in Figure 13. 



Staxtd&td Filfesyatfeirt DefinitiOrt 



1) toot Q« 8<iQa (teQUired) 

4) /var an sdOd 

5) /tmp t>n root ^rtltion 



(a) (b> 

6dl J B*4 32 ^ 7 



Ul9j<; p^3!:tltiorti^ (s-isne^ in WB)^ 
(c^ (d^ (€) . (£) 

190.^ 9*6 +«**+ •^"♦►^ 






m 



Enter number af fileBystem to change ( ^l"^*- '■S'^) , 'cDiitinue^ , '^previaus^ 
^OSurtO^X* f or ^?^ for "hi^lpt 



^ 



Figure 13. Modified Standard Filesystem Definition Menu 

Once all changes for the standard filesystems have been made, enter continue 
to proceed to the Media Identification Menu: 



^pKevious^, *oan.cel'^ or ^'?' for help; co^ticwe 



Installation Media Identification Menu 

The Installation Media Identification Menu specifies the location of the media 
which will be used during the installation. 

On Series S4000 systems, the default values are determined by how the ramdisk 
was booted. 

Figure 14 shows the Installation Media Identification menu of a S4000 machine 
that was booted from a local tape device stl (SCSI address 5). 

Installation may take place from Tape or CD-ROM. Each of these installations arc 
discussed below. 



Installing OS/MP 4. IB on a Standalone System 79 



S) I'ape host w locallioat :< 15:7. 0*0.1) 



helpt 



V V 

Figure 14. Installation Media Identification Menu - Local Tapehost 

Tape Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to 'local- 
host '. The Installation media type must also be set to 'Tape'. 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 15 shows the Installation media type menu 
with the CD-ROM parameters set to install fix)m CD-ROM. 

When the details of the media have been entered correctly, enter continue. You 
will be presented with the Package Selection Menu. If the operating system has al- 
ready been installed, you will be prompted to insert the optional software distribu- 
tion media. 

Package Selection Menu 

The Package Selection menu is used to install optional Solboume software distri- 
butions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
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Figure 15. Installation Media Identification Menu - Local CD-ROM 

related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solboume OS/MP Optional Software, is included on the OS/MP 
4. IB distribution tape. The following display shown in Figure 16 appears; the val- 
ues shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 



/€ntBx: nuTdber of paokag'e to a^^amiae C ^X' * . "^V ) , ^oanG^X' , "^ 
: Should the Solboarne OS/MP 4. IB Optional Software package 
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M"ia^<Jdtory Software: Will B^ in^tail^d 



Enter number af package to examine i^l*,*^!*^^. ^cancel,*" ,^ ^inatall*'^ or ""i* 



v__ 



y 



Figure 16. Package Selection Menu 

The Should the Solbourne Optional Software package be in- 
stalled question refers to the package in general. The modules are individually 
selected for installation on the customization screen, and by default all are selected 
for installation. 

After replying yes, the customization menu will appear as shown in Figure 17. 

• • • NOTE • • • 

Figure 17 is only an example. The Free KB reported will vary depending on the 
type and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule's name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 
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58^SS 
58695 

58695 
58$95 
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58€$$ 



iEjit.«tSMitj«ibi^r o;f tnodul^ to mcxilf y Cl^^vUS^), ^co^ntinu^' ^ ^ab'artS oj: '?' ^or ix<S(l^{ 



Figure 17. Package Selection Customization Menu 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
S/YP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. Sec 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 
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SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
5^0PEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, i.e. vtroff(l) and vplot(lG). 

UUCP - UUCP applications suite 

uucp(lC) and its support programs. These are normally used for communicating 
to other UNIX systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TLI 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• • • NOTE • • • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

Enter nttJPtiber of module t<3 modify i^^V . .'^IS^^f "^ccfXitixitieS 

The VERSATEC menu entry is highlighted, and: 

ladifyiifig t;he Vfitsat^c jatiriter Support lUiadiile 
Sliould the VBRSATSC module be installed O^^S- r ^no^'r '^Cr 

s ^r '*?* ■ for- h6flp)? jttO 

Figure 18 shows the updated display.: 
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Osst-omiz^tioo of SoW>o?32me: Q$/m A -IB Op^tAO^isX $<?ft.w3ir€! 



9} SYSTEMjr 
11> VSRSAfEC . 

I5> TLI 



^872 

W$^ 

1764 

3X2 

1632 

BB92 

■ n<f 

928 

4e 



Ins-tall Diiir«at6t5>> 



/usr 
/usr 



Fr^^ (KB) 
S4647 
64647 
64647 
$4647 
64647 
64647 
64647 
64647 
64647 
$4647 

64647 
64647 
64647 
64647 






Figure 18. Package Selection Menu - Deletion of Versatec Module 

• • • NOTE * • • 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 18. 

To install the GAMES module in /fun (on the root partition): 



Enter ntimber of module to modify {^V .."^15')^ ^continue' ^ 



The GAMES menu entry is highlighted, and: 



/Hbdifyi'og th^ ^8mej$ and t^moj^^tretioi^ prDgrr&w^ module ""^ 
"^t^ ton heip>t yes 

y^vn doeat ntst e^i^t* Cari^^t.^: At dx^-^riii^ ini5t9^3^ati<3o (^yes% 
ynoy -c, or '?' for help) 7 yes ^ 

The menu is updated to reflect the change, as shown in Figure 19. 

• ••NOTE*** 

The free space for /usr changes, and a completely new size (for /funj is also dis- 
played as shown in Figure 19. 
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Cua^tjomiatdtion ot SoXbov^rna OS/'W 4,X'^ Optional $t>tztff^^^ 

jaotJui^ sxaHfe(i?B> install i>ir'«<5tory r»feifr|KB) 

2) GAMES 2872 y /£d« 457S 

3) MMJtmL 73&2 y /ver lS75i$ 

^) usTWORKXjNG xo^e y /x^^r ^7^9 

5J ^LOt 17^4 y • /uar 675iS 

7) S^VJ'RO& 1832 y /uer ' ^7519 

^) SV^^J$ER ^§72! y /l;J«r .«75l» 

93 SrilSJ^^V 3992 y /ti«3; -67^9 

XO) tMT * ■ 7^<^ y • /«5r $7$i9 

XX)' ^R)SAT£C 5352 ii 

X^5 tJtrci^ «0a y /xt^jr ^73*3 • 

13) RFS 926 y /tist 675X9 

14) SJ^XS X3$^ y /tt^r ^75X9 
X^3 TI^I 48 y /«^J? ^7^19 

Eiit^r fiurtitoor ol uiodtiX^ to modify CX''*, ^X^Mr ''c-o*^tin.«eS ^aWrt;.', oj: "?' for 
help: 



Figure 19. Package Selection Menu - Install Games module to /fun 

If you decide to discard aU changes made to the modules, use the command 
'abort '. This returns to the Package Selection menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand 'continue'. This will record the changes and return to the Package Selec- 
tion menu. 

Wlien package customization has been completed (which may mean no packages 
were selected for installation), enter 'instcJ.1' as shown in Figure 20. 

The actual installation begins at this point, and may require 10 minutes to one hour. 

The steps taken during the installation are: 

1 . extract miniusr. (This contains the installation software, as well as enabling 
swapping.) 

2. create filesystems (root(/), /usr, or /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. create device entries 

4. install mandatory root files 

5. install mandatory kvm files 

6. install mandatory usr files 

7. install optional software 
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. Kpter Ruttiber af package to examine (*i' + ,■*!'): ,h ^cancel', *in3t.5|.il* ,^ or ''f 



V 



Figure 20. Package Selection Menu 

When installation has finished, the ramdisk menu is displayed (see Figure 21). If 
the installation failed, caU Customer Support. 

Rebooting from the Ramdisk 

After a successful installation, start UNIX by rebooting as show in Figure 22. 

Enter number of function to execute C r..'5', or '?' for help): 4 

At the Reboot System menu select Boot Unix: 
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P;atn<iisk 



^ 



1) Chanye Disk ^Artltionin^ 

t) InfiitaXl Software: 

3) Iitvoke a Boxirjife StielX 

4) ^^i>oot System 
$) HAit System 



Unti^x liUflib^K of £ujxotiori to <wt^c«ti.^ {'X' + ^^&% or ^?^ £03: h.<*Xi^)* 4 



V__ 



Figure 21. Ramdisk Menu 






1) Boot DniK 

2); Boot, otx xmtvSi&k 

3) Retu3cn to Idain Menu 



Enter jsoieation number (^l* * . '^3-^) or *?^ fot h.^Ip; 1 



Iteboot Sy9ti&tn 



Figure 22. Reboot System Menu 
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After selecting 1, there is a short pause, and then: 



Entry J 0»f<J0S000O 



05/M£^ 4,lB_Exj^!ii:t ( GENERIC /liQia^;^ #0t Tilfe^ May5€ 21:0^:24 

Ci?pyiclght (0) !&&$/ 1&$0 Sun Micrtigy^t^ma;^ inc^ asd 
Solbomrne Compute JTr tno* 



At this point, the system configuration information must be specified. 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



Copyright {c} 1985-1991 Sun Micro3yst.-smSjr Inc* -and 



Automatic c^eboot iu progress ^ 
Thur M^iy 2$ llS:55;42 PDl! I9i92 
checking qwotia-si don^. 



T^L$ 5yi5ti$m Ji^5 apt y^fe bie^n <::pnfa.^r^<;ix ^ev^i^^X wsIt^^^ 
n^ed tD be set before the aystem can come ttj> to muXti-xis^ec 

what i$ t:hi$ $yjstiem''$ m^itt^ {default =* ^^tiaiidaioae^ ) ; 

<H6t;.u3:n> 

^h^t i^ its Xijtemet addir-es^ <0 foe none/ defaw5.t ~ 
^2S5. 255* 255. 255)? <Retttr«>' j 



Using the default 'none' disables the NIS/YP services. 
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Australia/ 

Canada/ 

ChiX«^/ 

factory 



Choice 6: cir^f 

<5MT+3 
<3MT+4 

GMT+7 
<SMT-0 



G«T13 
GftJtS 



«MT6 
GMT 7 

GreenWiah 
HST 

Israel 

Jattmica 

Japan. 

M$'r7M0T 



fefideast/ 

FQlajn4 
ROC 

Turkey 

UCT 

US/ 

tin i verbal 
J&plu 



(^/' incli<ifat^© tilme iz-one pt&£iK'^s)t 



Enter tiaie izorte (default » ^tJS /Mountain* ) t V$ <1SU^tU^i:i> 

Alaska Central Hawaii Pacific 

Axriacwia East-eJrit Mountain. Samoa 

Bate^j titnfe^ isone: *loiintiain <Retttr«> 

^5t is today' 4 d^t^ <irm/4a/yyyy^ d^favsit * 0$/^$/:t$$2) §• <I^ttt>?»>- 

What fcoine is it f24*hotiir hh:mm^ iSefault « 16:j55)^ <Retttrn> 



Ctxa;;t^ftr>t 9^ttln^« ax;^*. 

Host natitie 

internet addK^9» 
. ■ifefcwork mask 

^ime zone 



s* standalone 

¥? OxOODOOOOO 
« Rodent V COM 
■* 5(JS(/Mountain 

■* os/ais/i&^a 

» 16i55 



Are- the6« aorreot (^y^s' or ^xio' ) ? 
yea 

Setting net mask of eiO to 25S»255.25S,D 

TU6 D0^ XI 22 f 09 too mT 1&9Q 

Setting password far root 

Changlii^ f>a$^word for toot on haiji trail* 

tJew password: 

Rety£>o t)^*if f>aasword{ 

Continuing boot 

startixig rpc Aiid n-et sairvic^st portaap t*- 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) tlic system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, cycle the power off and on . 

• • • NOTE • • • 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 




If the system booted successfiiUy originally, you may instead log in as root: 






In either case, if a file exists that tells the system it has been configured, remove it: 



|iiipiillli|j|illlll^^ 



The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 






Otherwise, use fastboot: 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing OS/MP 4. IB on a 
Standalone using reinst_sys 



This chapter describes how to install OS/MP 4. IB on a standalone using the new 
utility, reinst_sy s, which allows the user to upgrade his system with a full in- 
stallation of the operating system on unused partitions of one or more disks, while 
staying up in multi-user mode. 

A standalone system does not provide NFS disk services to clients. It also does not 
depend on a server for its root, swap, or /usr filesystems. 

The purpose of reinst_sys is to minimize downtime by performing a ftill in- 
stall of onto a new system disk while the system continues to run an earlier version 
on an old system disk. Once reinst_sys is complete, you are free to do what- 
ever local modifications are desirable before booting from the new disk. 

For example, you might reconfigure the 4. IB kernel or modify files of local interest 
such as /etc/printcap. Only when the new system disk is ready to run do you need 
to halt the old system and reboot from the new disk. 

Finally, unlike earlier fuU install releases, reinst_sy s makes it possible to fall 
back to the earUer version of OS/MP if there turns out to be some problem with the 
way you set up the new system. To fall back to the old system, halt the new system, 
change ROM variables DEFAULTROOT and perhaps DEFAULTSWAP, and 
then boot. 

• ••NOTE*** 

In order to use this utility, you must have an unused disk, or at least enough unused 
partitions, on which to install the OS/MP 4JB release. You can not use reinst_sys 
to install over the currently running disk partitions. If you do not have an unused 
disk for reinst_sys to use, you will have to install OS/MP 4.1 B from scratch, while 
the system is unavailable to your users, as was done in previous OS/MP full instal- 
lation releases. 

You should not install on a disk connected to a channel board as it will be impos- 
sible to boot from that drive. 
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Before Installing... 



Extracting reinst_sys via a 
Local Tape Drive 



• • • NOTE • • • 

Before using reinst_sys, you must know what disk(s) and partitions you want to in- 
stall on. If changes need to be made to any of the disks partitions, you must do this 
prior to running reinst_sys. Use partitionfSj to modify the disks. 

It is best to select a disk that will be recognized by an OS/MP 4.1 B generic kernel. 
Otherwise it will be necessary to reconfigure the kernel (which may be desirable 
anyway) before rebooting. This is discussed in more detail at the end of this sec- 
tion. 

• • • CAUTION • • • 

If installing by tape, clean the tape drive on the machine you will be using be- 
fore installing the release tape. Failure to do so may result in damage to the 
release tape. 

To run reinst_sys, it must first be extracted from the OS/MP 4.1B media. 

Tlie following explains two different methods of extracting reinst_sys into the 
/usr/etc directory. You must be logged in as root. 



/Ca.lly# cd /usr/etG 



Extracting reinst_sys via a 
Local CD-ROM Drive 



Create a mount point directory (if one doesn't exist), mount the CD-ROM drive, 
and extract reinst_sys as follows: 



/£a.lly# mkdir /cdrom 
telly# motjnt /d^v/srO /cdrom 
t^XXyl C(X /u5?r/etc 
te3-iy# t^r ?cpf /•qidrom/l'ooXsi^tsr 
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Installing. 



This section covers the OS/MP 4. IB installation on SeriesS, SeriesSE, Series6 and 
S4000 systems. 

During installation, you can request help at any prompt by entering a question 
mark. Table 1 shows edit commands available when entering text in response to 
prompts: 

Table 1. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete (^1) 


delete last input character 


AU 


erase input line 


'^R 


redisplay input line 


AW 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, retoming to nearest menu 


AL 


redisplay entire screen 


return (f^M) 


end input 


newline C^J) 


end input 



If a String is too long to be displayed in the available space, the beginning of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



/f ■*Jstty sane'" J 

# Xlft —f COXB 



where ^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 
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Installing Software 



Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 

There are three information gathering menus: 

a Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /imp) are located. 

O Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

D Package Selection - allows selecting of which optional software packages are 
to be installed. 

AU three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the sheU terminating reinst_sys. 

previous always returns to the previous menu (which is the shell, in the case of the 
Filesystem Definition menu). The changes discarded in this case arc those made in 
the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. You 
can add entries for any local disks to /etc/fstab after installing the system as a disk- 
less client. 

Any changes made to the standard filesystems with partiUon(8) will appear in this 
menu. 

reinst_sys has tlie following options: 

reinst_sys [-m] [-n] [-r /root/path] [-f host:/device/path] [-a arch] 

-m Don't mount or newfs filesystems 

-n Don't newfs filesystems 

-r /root/path Pretend /root/path is really/ 

-fhost:/device/path What tape device to use 

-a arch What cpu archilcciure to use - overrides cpuslaius 
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In general, you will not need to use any of these options except perhaps the -a op- 
tion. The -f option will be set while running reinst_sys. 

The -a option is to be used when you are upgrading or changing the architecture of 
your machine. Suppose you have a machine with Series5 CPUs, and you want to 
upgrade to Series6 CPUs, To install the OS/MP 4. IB for Series6, login as root and 
issue the following command: 

( ^tellyt /usr/etc/yein.gt__ays -'a^S^rie3^ J 

To install OS/MP 4. IB with no change in architecture, login as root and issue the 
command: 

reinst_sys begins by reading the current /etc/fstab file to determine the disks 
attached to your system (mounted disks are also probed). 

After examining all attached disks, reinst_sys presents the first menu, the 
Standard Filesystem Definition menu. 

The root, swap, and usr partitions are required and must be defined before going to 
the next menu. The swap will be defined as the current swap area, and may be re- 
defined if you wish. The root and usr areas need to be defined from the currently 
available disk partitions that are highlighted in the Standard Filesystem Definition 
menu. For a disk partition to be available for use in reinst_sys, it must not be 
currently mounted, and it must not have an entry in the /etc/fstab file. 

Example: 

Currently, the root(/) filesystem is on sdOa, swap is on sdOb, and the /usr filesys- 
tem is on sdOg. Available partitions are highlighted. If the necessary partitions are 
not available, exit reinst_sys. A partition may not be available because it is 
mounted or an entry exists for it in the /etc/fstab file. Also, it may not be available 
because it does not exist, or it is not large enough, in which case you will need to 
run partition(8) to repartifion the disk as needed. 

Use the following steps to assign the root (/) filesystem to sd2a, the /usr filesystem 
to sd2g, and the /var filesystem to sd2d (rather than using the default of /var being 
a subdirectory of the root filesystem). 

The steps for changing /var are optional. This makes use of partition d, thus using 
9.5 MB of disk space that is not used when the default disk partition is used with 
the standard filesystem definition. 

In Figure 1, the notation "(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any sufficiently large available partition of any disk. 
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Figure 1. Sample Standard Fiiesystem Definition Menu 
To modify the root (/) fiiesystem, enter the number 1. 



^continue'' ^ ^ptevious^ , ^cancel'' or ^?*' £or help* 1 



The root menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2a. 



:Entet a&me o£ di^k p^ctitlon qx ho$tfpi3th foe /?root 
fiiesystem^ ^noneS '^C^r or^?' for helpi sd2a 



To modify the /usr fiiesystem, enter the number 3. 



Enter rxumber of fiXesystem to change ( U^ + + '>5') , 
^eontinufe' ,h ''prret^riciii^''^ ^eano^i-'' or ^V for h^lp: 3 



The usr menu will be highlighted, and the system will request a disic partition. As- 
sign it to sd2g. 



Enter name of disk partition or host: path to'x /usr 
fil6$yst0rn, 'rtOri^*^^ '^C^ Or^?' for h$tlp: Sd2g 



To modify the /var fiiesystem, enter the number 4. 



Ent^r number of fiiesystem to c>hanc[e^ f*l';^^$'>r 

^continue', ^previous' ^ ^cancel' or ^V for help: 4 
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The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2d. 









The new arrangement is displayed as shown in Figure 2. 



%\ £06t nil ea2it -^tifeKSfUiteia.) 

4 J /vax aa sd2d 

(a^ ii>\ <c) <d} te) ^ m m %^^ 

*<J2i 6*^ 32 *& 4M>.^ 9*5 *«"^- -»*-«« 433*j5 "^*^ 



Inter nairfaex a£ f ileeysfcem- to tshange pi'^.'-S'^)^ "cwaatinvie-' * "^ftr-eviQiiis' <• 



\ 



Figure 2. Modified Standard Filesystem Definition menu 

Once all changes for the standard filesystems have been made, enter continue 
to proceed to die Media Identification menu. 

Installation Media Identification Menu 

The Installation Media Identification Menu describes which media type (tape, CD- 
ROM, or network directory) will be used during the installation. Figure 3 shows 
the Installation Media Identification menu. 

Installing from a Tape Drive 

Installing from a local tape drive requires that the Installation media type be set to 
Tape, the tape drive field be set to either stO or stl (the only supported tape 
drives) and that Tape host be set to localhost. 
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I S) l^^pe host: *f iars^ijiost <1^7, 0,0*1.} 



Mips 



V 



J 



Figure 3. Media Identification Menu - Local Tapehost 

When the details of the tape drive have been entered correctly, enter continue. 
You will be presented with the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 

Local CD-ROM Installation 

Installing from a local CD-ROM drive requires that the Installation media type be 
set to CD-R(M4, the CD drive field be set to /dev/srO, and the CD host field be 
set to localhost. 

Figure 4 shows the Installation Media Menu with the CD-ROM parameters set to 
install from CD-ROM. 

Once the details of the media have been entered correctly, enter continue to pro- 
ceed to the Package Selection Menu. 

Package Selection Menu 

Use this menu to install optional Solboume software distributions. It provides a 
menu-driven method of examining the components of the distribution tape, select- 
ing the parts to be installed, and specifying the directories where the components 
will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
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Figure 4. Installation Media Identification Menu - Local CD-ROM 

related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, OS/MP 4. IB Full-Install Optional Software, is included on the 
OS/MP 4. IB distribution tape. The following display shown in Figure 5 appears; 
the values shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 



/ib.ter ntaaber o£ package to examine C^V *^^%*if ^cancel* / 
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Figure 5. Package Selection Menu 

The Should the OS/MP 4. IB Full-Install Optional Software 
package be ins tailed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu wiU appear as shown in Figure 6. 

• • • NOTE • • • 

Figure 6 is only an example. The free KB reported varies depending on the type 
and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule's name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the fiiee space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGEVG - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 
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Figure 6. Package Selection Customization Menu 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable fonn. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that wiU use the NI- 
S/YP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminais. See 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word fQes in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 
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SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OPEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text foraiatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lQ and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TU 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• ••NOTE*** 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 



(^ 



^^aboct'^ or ^7* for helpj XX 



The VERSATEC menu entry is highlighted, and: 



fexlifyiagr tha -^exBatec printer stjjpport module 



?.r ''7^ for help^"^ no 



Figure 7 shows the updated display.: 
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Figure 7. Package Selection Menu - Deletion of Versatec Module 

T«r • • NOTE • • • 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 7. 

To install the GAMES module in /fun (on the root partition): 



^afeo3:t'jr ox ^f tox h^lpi 2 



"-'""■ •-"-•.) 



The GAMES menu entry is highlighted, and: 



/^odtt^in^ ttste games a«d deatotistratioti g^rogr-aima jBodtil^ ^^ 
Should tbe <5J544£S module ba installed {"^yes'^ *3f«>'^ ^C^ «3: 

/tun does not -estiat. Create it dmcixig inatal.lati.oaa (^jfea*"^ 

The menu is updated to reflect the change, as shown in Figure 8. 

• • • NOTE • • • 

The free space for /usr changes, and a completely new size (for /funj is also dis- 
played as shown in Figure 8. 
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Figure 8. Package Selection Menu - Install Games module to /fun 

If you decide to discard all changes made to the modules, use the command 
abort. This returns to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and retum to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 9. 

The actual installation begins at this point The steps taken during the installation 
are: 

1 . create filesystems (root(/), /usr, possibly /var or /tmp 

2. create device entries 

3. install mandatory root files 

4. install mandatory kvm files 

5. install mandatory usr files 

6. install optional software 
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Figure 9. Package Selection Menu 

When installation has finished, it gives the following message: 

F-t&as ariy ciiai?acter to coutinae 



The next display gives the values of the previous and new ROM variables DE- 
FAULTROOT, DEFAULTSWAP (if they have changed), and asks if you want to 
update the variables, as shown in Figure 10. 

iK-Ai^ NOTE i< i^ i^ 

Before you say 'yes' , make sure that all the previous settings of these variables are 
recorded so that you can later reboot from the old version of the system if neces- 
sary. If you choose not to update the ROM variables, make sure that you record the 
new values and use them to reboot the newly installed system at a later time. 

reinst_sys then performs the final system setup, and completes. The new sys- 
tem's filesystems are currently mounted under the /etc/sys_conf/reinst_sys/root 
directory. For example, the new version of the /var directory is moimted at /etc/sy- 
s_conf/reinst_sys/root/var. 

At this point, the newly mstalled system is ready to boot. However, you may want 
to finish the installation by creating or editing such files as /etc/rclocal, auto- 
mounter maps, /etc/printcap, the /var/spool directories, NIS/YP maps, or any oth- 
er files local to your system. If you have comments in your/etc/fstab file, they will 
not exist in the new /etc/fstab file, so you may want to edit this file. 
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Figure 10. Update ROM Variables 

• ••NOTE*yr* 

If you installed the new system on a disk that is not recognized by a 4. IB generic 
kernel, then you must reconfigure the kernel before rebooting. 

You may also wish to create a customized kernel on the new system, so that hard- 
ware such as the channel board and VSCSI devices will be recognized. If you 
would rather wait until after rebooting the new system to configure your kernel, 
you should edit the new /etc/fstab file and comment out any partitions which are 
on disks not visible to the generic 4. IB kernel. 

After you have completed customizing the new installation, reboot your machine, 
using the new ROM variables. 

If you used the -a option to upgrade to a different architecture, then after custom- 
izing the new installation, halt the machine and turn off the power. Replace the old 
CPUs with the new CPUs, power up and boot your machine using the new ROM 
variables. 
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Before Installing... 



Installing OS/MP 4. IB on a Server 



This chapter describes how to install OS/MP 4. 1 B on a server. A server is a system 
that is on a network and may provide NFS disk services. 



• • • CAUTION • • • 

Perform a full system backup before installing OS/MP 4.1B. A complete in- 
stallation overwrites all information on the disk partitions specified for the 
root (/), swap, /usr, /var, and /tmp filesystems. 

Before installing the release tape, clean the tape drive on the host machine. 
Failure to do so may result in damage to the release tape. 

Any host on a network must be added to the hosts database. Before you can add a 
host to either database, choose a name and an address for that host. Be sure both 
are unique for your network. Determine which one of the three network infonna- 
tion databases you are using. 

n Static files - this is the simplest form of the databases: two files, /etc/hosts and 
/etc/ethers. 

n Network Information Service - NIS, formerly called Yellow Pages (YP), is a 
centralized version of the static files approach. Fundamentally, one system, the 
NIS/YP master, uses the static files. Other systems ask the master to look up 
entries in its files. 

n Domain Name Service - DNS is part of the software used to administrate the 
Intemet, and is beyond the scope of this document. If you are using it, contact 
your system administrator for information on updating entries in it 

If you are using NIS/YP, take the following actions on the NIS/YP master. If you 
are using static files, take the following actions on the system that is to act as a serv- 
er (by providing either its tape or disk drive). Only the supemser (account name 
root) is allowed to update these files. 

O Update the hosts database with the name and IP address chosen for any new 
client by adding a line of the following form to /etc/hosts: 
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□ If you are installing a diskless client on your server, update the ethers database 
by adding a line of the form below to /etc/ethers. The six colon-separated 
numbers are the ones displayed by the system when the power is turned on. The 
name must be the same as was added to the hosts database. 

(^'O:0t;ae;i0yo?i^ h^^ .. ......0 

□ If you are using NIS/YP, the working copy of the database must be updated: 



Installing... 



Installing on a SeriesS, 
SeriesSE or Series6: 



• ••NOTE*** 
Execute make on the NIS/YP master server only. 



This section covers the 4. IB installation on SeriesS, SeriesSE, Series6 and S4000 
systems. 



Loading the Ramdisk 

The following explains four different methods of loading the ramdisk. After you 
have loaded the ramdisk continue on to the Dishful Installation section. 

Loading the Ramdisk via a Local Tape Drive 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



v^ ,^ 



Z) 



The system asks if you want to re-install if INSTALLED is not 0. 

To load the ramdisk on SeriesS or SE systems using a local tape drive, enter a boot 
command in the following form: 



C^^^^^^.J^'^^....^^--/^^^^^ 



J 



To load the ramdisk on Series6 systems using a local tape drive, enter a boot com- 
mand in the following form: 

^'|^>' bQ0t''$t^>^i'^7^^^ ) 
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The variable TapelD shown in the command should be replaced with the SCSI ID 
of the tape drive to be used. For stO, use 4; for stl, use 5. 

The bootROM copies the ramdisk image into memory and boots it: 

entry: OjjMO&OOOO 

The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. Proceed to the Disl(ful 
Installation section 

Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following example, 
must be on the same network as the system being installed, referred to as hamster 
in the following example. For example, with a class C network, the first three num- 
bers in the Intemet addresses of the two machines must be the same, such as 
192.1.3.42 and 192.1.3.17. Also, /wwwrer must be listed m /etc/hosts, or in the NI- 
S/Y? hosts database, and /.rhosts ovl tapehost. In addition, the ethemet address 
must be in the ethers database. The ramdisk must be extracted from the OS/MP 
4. IB distribution tape onto a disk on tapehost. 

tapehost must also be rurming rpc .znounted(8) n£8d(8) and rarpd(8) 
daemons. 

Since the system uses tftp(l) to load the ramdisk image, it must be enabled on the 
tapehost. Examine the file /etc/inetd.conf. A line similar to the one below should 
be in the file: 

U- * 

If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 Mbytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

^ '. ^ 

249! ^ t ^t^l iRet;<5 



\^ S-41 p3 ^ ^*^^ egrep jjtetd 
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The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

( t^pehggt f MIX -HW j>id • } 

Put the distribution tape into the drive and execute the following commands. 

• • • NOTE • • • 

In the following example the install kernel will be named Ivar I tmpi install. The ac- 
tual name of the file is not important, so long as it is used consistently here and in 
the example on the next page. Also note that thefilesystem must have enough space 
to hold the install kernel. 

In the mt command below, replace the variable X with one of the following values, 
depending on the type of system. 

Table 13. 



System 


Value of X 


SeriesS and 5E 


2 


Series6 


3 



For Exabyte tape drives, use bs=1024 instead of bs=5 12 in the dd command shown 
below. 



Enter the following boot command on the system being installed: 

(|;&c^>l?'fc^ ^ 

In the example above, the variable hostnumber should be replaced with the last 
of the four numbers in the tapehost's Internet address. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

The system will ask if you want to re-install if INSTALLED is not 0. 
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Install the OS/MP 4. IB CD-ROM disk into the CD-ROM drive. 

tV * • NOTE • • * 

In order to boot from the local CD-ROM disk, the bootROMs must be at version 
3.5 or higher. For this reason, local CD-ROM installation for Series4 is not sup- 
ported. 

To load the ramdisk on SeriesS or SeriesSE, using a local CD-ROM drive, enter a 
boot command of the following fonn: 

To load the ramdisk on Series6 systems, using a local CD-ROM drive, enter a boot 
command of the following fomi: 

The bootROM copies the ramdisk image into memory and boots it: 

ib«t a i9d, «i ( , 6 1 > / Install ^ Ser ie 3 ^ '■ ' 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk from an image area of the OS/MP 4. IB contained on a remote disk 
accessed over the networic. 

Power on the system. After the system passes the self -tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to deteraiine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

('j^|.i^- "jSeteiw^ iRjgfcg^ •■ • ) 

The system will ask if you want to re-install if INSTALLED is not 0. 
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If you are installing by a remote CD-ROM drive (via the network), install the 
OS/MP 4. IB CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 






The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192. 1 .3.42 and 
192.1.3.17. Also, the local machine must be Hsted in /etc/hosts, or in the NISA^ 
hosts database, and in /.rhosts on diskhost. In addition, the ethemet address 
must be in /etc/ethers, or in the NIS/YP ethers database. 

diskhost must have /cdrominits /etc/exports file, and must also be run- 
ning the rpc .mountd(8), nf sd(8), and rarpd(8C) daemons. 

Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost. Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 

/tftp dgram-udp wa.1% root. /usr/etc/iD.tftpd iti.tftpd -s >. 

\ /tft|!^i>oot ' : • ^_^ J 

If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 6 
Mbytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

/Slskhoat # ps ax; | ^g£«tp Irietd ^^ "^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

(dig-lKly>$t# M^^ ) 
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In the boot command below, replace the variable X with one of the following val- 
ues, depending on the type of system 



Table 14. 



System 


Value of X 


SeriesS and 5E 


5 


Series 6 


6 



Enter the following boot command: 

Diskfiil Installation 

Once the ramdisk is booted, it first detennines what sort of tenninal you are using. 
If you are using a serial terminal, that is, a terminal attached to the ttya/ttyb port, 
or if the bootROM variable CONSOLE is not set, the system displays a list of sup- 
ported temiinals: 

/l) =&!<) . ^ 

3) ^p- ■ 

€) vtlOO 

If a frame-buffer is being used as the console, select the 4, the sim terminal type. 

(what type of terminal ar^ you using {^V^.^VM A ) 

If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 

D6 y&u want to te-^inat^ll %h.^ ;$Y$t$ift. (^y^^*^ *iiO''/ ot *^' 

The above message is for the benefit of users intending to re-instaU the system soft- 
ware, but have not reset the INSTALLED environment variable. 
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If the message appears, enter yes to re-install the mandatory system software. 

The disk drives attached to the system are then scanned, and the system displays a 
menu of procedures: 



2) Xn9t^ll software 

5> Halt System • 
3Sj%t.-er jjumbeK of fuo«tio» to ^xeouta C^X' >.m '^B^^ o-r ^7' tox 

The provided functions are described as follows: 

Change Disk Partitioning - Allows the changing of the sizes of disk partitions, 
and what those partitions are to be used for filesystem space, swap space, or unused 
space. 

• • • NOTE • • • 

If you are going to make changes to the disk partitions on which OS/MP 4.1 B will 
reside, make those changes before installing software. Disk partitions not contain- 
ing OS/MP 4. IB can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
boume software distribution, such as X Windows. See the section 5<9//ware Instal- 
lation from the Ramdisk for more information. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the format(8) command. If they are, you must then 

selectChange Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts the UNIX operating system after software installation. Al- 
ternatively, you may reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 



Installing 0S/MP4.1B on a Server 117 



You can request help at any ramdisk prompt by entering a question mark. Table 15 
shows edit commands available when entering text in response to prompts: 



Table 15. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


'^U 


erase input line 


AR 


redisplay input line 


AW 


delete input up to 7' or whitespace 


'^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


AL 


redisplay entire screen 


return (^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as " . . . *'. This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as *co* for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 






where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Install Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 
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There are three infonnation gathering menus: 

O Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /imp) are located. 

D Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

D Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. You 
can add entries for any local disks to /etc/fstab after installing the system as a disk- 
less client. 

Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Normally, no changes need to be made at this menu. To proceed to the Media Iden- 
tification menu, enter continue. 

Example: 

Use the following steps to assign the A^ar filesystem to sdOd, rather than using the 
default of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 23, the notation * '(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any partition of any disk. 
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2) swap -on sdOh- fr6<jUiJEr6<i> 

• 4^ /vat oft root |)attition 
iS): /tmp -on ?oot partition 

£>isk E^artitiona ^sixBK in WS)- 

' i^> 0>) (o . (d) (^) ^f) f^) cfcjf 

sdQt 8*4 32.4 l&l.l . 3,3 141;1 

ft^lt 3*4 a^^y"? ' I»0>S^ ^.$ 140»9 



Eat^r «t«nJ?6r 0^ tll^jgys-t-^m to oh-^ii^^ (n**x^&*jy "'cotittn\ie% *$J3:-«vi<ms' ^ 
^cancel*' ^ ar *?' for baip-r 



V : J 

Figure 23. Sample Standard Filesystem Definition Menu 
To modify the /var filesystem, enter the number: 4. 



■» continue ' / ^pre-vioBS'' ^ ■* cancel^ or ^T*" fox helpt 4 

The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 

The new arrangement is displayed as shown in Figure 24. 

Once aU changes for the standard filesystems have been made, enter continue 
to proceed to the Media Identification menu. 

^GOTitinta^' r ^previoias^^ "^-casacelS or '^^^ for tialp** contiiiw 
Media Identification Menu 

The Media Identification Menu describes which media type (tape, CD ROM, or 
netwoiic directory) wiU be used during the installation. Figure 25 shows the Media 
Identification menu. 
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Figure 24. Modified Standard Filesystem Definition Menu 



Media tdfiiitifiaation 

ij Iiictflllation media type « iSTape 
^J TAp6 4i:iv^ « «ta 

3) Iiocal Internet addreBs =1* i). 0,0*0 {required for remote taJ}e•^ 
: 4E) Wet-vorlc iwroadcat^t •ma^k « <^5cf£f.fOOO<3- fj^-^i^uiir-^d for at^mot'^ t^p^*) 
5) "Eap^ h.o«t « localhost <1 27 ♦0*0.1) 






V. 



Figure 25. Media Identification Menu - Local Tapehost 
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Local Tape Drive Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to local - 
host. The Installation media type must also be set to Tape. 

Remote Tape Drive Installation 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /j*hosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Qass C networks). A leading *0x' is necessary if entering 
the mask as a hexadecimal number. A leading '0* is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Internet address. The name itself, however, is not espe- 
cially important (it is discarded after the instaUation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 26 shows the Media Identification Menu of a system that is set up to install 
from a remote tape using tape device stO (SCSI address 4). 

When the details of the tape drive have been entered correctly, enter continue. 
You will be presented with the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, die CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 27 shows the Installation Media Menu witii 
tiie CD-ROM parameters set to install from CD-ROM. 

Network and remote CD-ROM Installations 

Installation media type must be set to Network 

Installation directory should be the fiill path name of the location of the instaUa- 
tion area, or the fiill path of the CD-ROM mount point, on tiie network host. For 
example, if the remote CD-ROM is mounted on /usr/cdrom, then the installa- 
tion path is simply /usr/cdrom. 
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Figure 26. Media Identification Menu - Remote Tapehost 
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Figure 27. Installation Media Identification Menu - Local CD-ROM 
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The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /j*hosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Qass C networks). A leading *0x* is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the installation directory, 
which is used to determine it's Internet address. The name itself, however, is not 
especially important (it is discarded after the installation is complete). As such, the 
default name, tape-n-boot-serv, generally need not be changed 

When the details of the media have been entered correctly, enter continue. If 
You will be presented with the Package Selection Menu If the operating system has 
already been installed, you will be prompted to insert the optional software distri- 
bution media. 

Package Selection Menu 

Use the Package Selection Menu to install optional Solboume software distribu- 
tions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solboume OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solboume OS/MP Optional Software, is included on the OS/MP 
4. IB distribution tape. The following display shown in Figure 28 appears; the val- 
ues shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed mdicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. You must examine the package if you want it installed. 



124 InstaUing OS/MP 4.1B on a Server 



r 






Et)ifc«r tMSEntbej? o£ p^cjkage to examine f^L^ j-. *^1*) ^ ''a^n.cel* ^ *4-D&taiJ.' ^ or *?^ 



V_ 



Figure 28. Package Selection Menu 

To examine the modules available, select the Optional Software package: 

: Should tti© Solboum© OB/mJ* 4x1B Optional So£t.w<ftr« package 

The Should the Solbourne OS/MP 4 . IB Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu will appear as shown in Figure 29. 

ifr • • NOTE • • • 

Figure 29 is only an example. The free KB reported varies depending on the type 
and size of disk drive installed. 

The size of each module in kilobytes is hsted immediately to the right of the mod- 
ule's name. The column after the size indicates whether or not the module is cur- 
rently marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 



Below are short descriptions of the individual modules: 



Installing OS/MP 4. IB on a Server 125 



0«fft<?mi5!<itfii<*« K>t $-CiiUx?v>*n*i; 0$/M ArlB OptAon»l"l5<>ft*l'flMR#-5 






») GAMES 

3-) umxiAL 



2B12 
7392 

■ 31^ 

1632 

S992 

■ 7^<^ 
SS52 






y 

S' 
y 

y 

y 
y 
y 
y 
y 
y 
y 
y 
y 



/lis 3? 



38695 

seeds 

^86Si5 
5B695 

S86d5 

58695 

US9$ 






Figure 29. Package Selection Customization Menu 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable form. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that wiU use the NI- 
SAT database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
fi"om simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 
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SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows wiU be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
X/OFEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLI6 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TU 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• • • NOTE • • • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 
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For example, to not install the VERSATEC module: 



^afcH>rt^^ ox ^"^^ for h^lpx IX ^ - - , 



) 



r 



The VERSATEC menu entry is highlighted, and: 

?a: ^^^ for 3a^Ip>t i!to ^^j 

Figure 30 shows the updated display. 



e:?a-*t:ppa.»attion ^t $<?Jti«>tMr»ift '0%fW 4-^X^ <!^pfcionai ^^tKyt'^Xr^ 



13} SFS 
14) 3HIiIB 
1^} S'litt 



2572 

1832 

3952 

SS52 

92& 
136S 



Software 'HaduJto^- 



/tier 



' €4$4t 

«4647 
^4^47 
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^4$4'? 
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jh.'sXp: 
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Figure 30. Package Selection Menu - Deletion of Versatec Module 



lAr^^NOTE*** 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 30. 

To install the GAMES module in /fun (on the root partition): 
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The GAMES menu entry is highlighted, and: 



r~ 



/^o^Sifyitig tiie gaipctes. aoddainonst ration prograiRis module 

aijo«M tM ^m^z module i^ iti^taii^iJ ( ^y^$^ ^ . '^tjo' , '^c, ok 
'^1* tax: help)? yes 

/tun doBS not e;H:i3t* Create it <Juring instellation (^yes"^ir 
\ ^no-^ ^ /^Cr Qji: ^^-^ for Help) ? y&a ^ 

The menu is updated to reflect the change, as shown in Figure 31. 
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Figure 31. Package Selection Menu - Install Games module to /fun 



tSt A 7^ NOTE 7^ • :^ 

The free space for /usr changes, and a completely new size (for Ifxxn) is also dis- 
played as shown in Figure 31 . 

If you decide to discard aU changes made to the modules, use the command 
abort. This returns to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 32. 
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Figure 32. Package Selection Menu 

Actual installation begins at this point, and may require from 10 minutes (if only 
mandatory root files are being installed and a local tape drive is used) to about two 
hours (if everything is being installed from a remote QIC- 150 tape drive). 

The steps taken during the installation are: 

1. extract miniusr. (This contains the installation software, as well as enabling 
swapping. The root disk might not be repartitioned after this step without 
requiring reinstallation.) 

2. create filesystems (root(/), /usr, or /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. create device entries 

4. install mandatory root files 

5. install mandatory kvm files 

6. install mandatory usr files 

7. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 33). If 
the installation failed, call Customer Support. 

Rebooting from the Ramdisk 

When the Tape Change selection is displayed, type continue . 
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Figure 33. Ramdisk Menu 

After a successful installation, start the UNIX operating system by rebooting as 
shown in Figure 34. 

Enter number of fimction to execute (' 1 '..'5*, or '?' for help): 4 

At the Reboot System menu select Boot Unix: 



^ ■ ■ • ■ ■ • ■ ■■ ■ 

After selecting 1 there is a short pause, and then 

/^tJt omatic boot enabled * '^ype • Coat rol-C to abo Kt- 
MM> boot 
a<3ot; $<3.-3i<O*0*O)/v«pani?; 



19^2 ^ 

Copy^lgiit (o) XM9^ 19&& Btm bJiciroayat^Ris^ lisc* awd 



3 
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Figure 34. Reboot System Menu 

Now you must specify system configuration infonnation. 

Disabling tftp 

If the ramdisk was loaded fix)m a remote tape drive, tftp(l) was enabled at that 
time. 

For security reasons, it should now be disabled on the system ftom which the tape 
was read. 

First, comment out the line, as shown below, in /etc/inetd.conf: 



ftftp dgraat m<^ wait ^oot /us£/stc/lri*tffcpd i»*trftjpd 



3 



Next, determine the process ID of inetd(8): 



/€apehost# ps aa: | egrep inefcd" 
541 p3 :g^ 0-:00 egrep iaet<3 



^ 



The /7irf of inetd is the first number on the Une that doesn't contain egrep. In the 
above output, pid is 249. 
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Last, signal inetd to re-read the configuration file: 



^ tapehos.t# kllX ^^^^^ P^^ 



J 



After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 






Thut Way £8 1$;$$;42 &&^ 15^2 
cfeeokingr qaDtasj don©* 



lieed to b«: s^t before ■the -systaro cat5 -coma mp to mult i -user 

Wfe^t is tJie network broadcast mask ^defauXtt *» OxffffffOO)? 
^$it i^ the »X5 4o*ftaift nasflfi ^^non^* ioi? noce^ 4e^avlt ^ 



V. 



• ••NOTE*** 
Using the default 'none' disables the NIS/YP services. 
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»bat ti*e l« It (2^^h.<ia£ l»h*iw5il^ default 



■■ 1€j5SJ ? <Ret«13at> 



Most, name- 
^^tiwork m&sk 
Tim© zone 



* hafaitarail 
*^ Ox£££fff 00 
«^ OS/Motmtain. 



Ares t&e»e corjETe^t { ^ye«-' ot ^xiO' J ^ 

Sfititing tietma^fc of aiO t>o 23S^255*2SS,0 

d&t-tintg password for xoot; 

Ch^n^ia.^ ^A^$wojr4. £■!>£ root ot> Iiafoit3?«ii ► 

New paaaword: 

C6»ttt5tuiitg bt&ofc 

44;^rtioi3 irp<f ^n4. •o^ei1?■ ;9i^jpv|,<5!^4;^ portunap C- 



.*J 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is straight forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button. 

• ••NOTE*** 

If automatic boot is enabled, interrupt the reboot by typing Control-C in the early 
stages of the reboot; otherwise the system will hang up as before 

Then bring up the system in single-user mode: 

_^...^^^^^^...^^ 

4*-' •'^ , . . . . . . 

If the system booted successfully originally, you may instead log in as root: 

^^at^^«^5^ \ ^ 

In either case, if a file exists that tells the system it has been configured, remove it: 

The above file may not exist; this is not a problem. Go to the next step. 
Now reboot. If you are in single-user mode, exit: 

(# «atit ■■ ) 

Otherwise, use fastboot: 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing on Series S4000 



Loading the Ramdisk 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

Loading the Local Ramdisk via a Local Tape Drive 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to detemiine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

The system asks if you want to re-install if INSTALLED is not 0. 

Install the OS/MP 4. IB distribution tape into the tape drive and enter the install 
command. If there is more than one tape drive, the bootROM asks which tape drive 
to use. For example: 

Khicfet tj^e of device du you vi^li to iajstali fjcomf 

■£lot^^ device type; 1 

Yovt hav^ thfi: fo-licwirig tajse iSrlve^. ^i^^^^ »hoo$^ one; 

lit At l^tgi^t^^ dtive Ji^EKtej ARCSIVS VXPSS. 1$0 ^lS4t'H-00$ 
2> at ^ax?getSr drive namet EXAB-YasJ mSB'**B2M Z^lK 
Biiter device »T:»nber: 1 

"^ : ^ 

The bootROM copies the ramdisk image into memory and boots it: 

Eu-tryj 05S3Ed08O00O 
X ^ize^ OxeaQQ0-i"Ox43l?87g^OK3aSfO / 

The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. 

Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following example, 
must be on the same network as the system being installed, referred to as hamster 
in the following example. For example, with a class C networic, the first three num- 
bers in the Internet addresses of the two machines must be the same, such as 
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192. 1.3.42 and 192. 1.3. 17. Also, hamster must be listed in /etc/hosts, or in the NI- 
S/YP hosts database, and /.rhosts on tapehost. In addition, the ethemet address 
must be in the ethers database. 

The ramdisk must be extracted fiiom the OS/MP 4. IB distribution tape onto a disk 
on tapehost. 



Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the tapehost. Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 

(tftp dga^^am. %j;dp wsit sroofe /u»r/etc/lR»tffepci i»*tft|?d -^ 

If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

f tapehos-t. # Mil «HU? p±d ^ 

V ^ r'. J ' 

tapehost must also be running rpc .mounted(8) n£sd(8) and rarpd(8) 
daemons. 

Put the distribution tape into the drive and execute the following commands. 

• ••NOTE*** 

In the following example the install kernel will be named /var/tmp/ install. The ac- 
tual name of the file is not important, as long as it is used consistently here and in 
the example on the next page. Also note that thefilesystem must have enough space 
to hold the install kernel. 
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For Exabyte tape drives, use bs=1024 instead of bs=512 in the dd command shown 
below. 



The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to detennine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



Q ^CM> -geteav iixst^alled 



3 



The system will ask if you want to re-install if INSTALLED is not 0. Enter the 
install command, selecting network installation. In the following sample interac- 
tion, sample Internet addresses are shown. Where the system prompts for an Inter- 
net address, you should enter the value assigned to your system. 

/^QH^'It^st^ii '• '\ 

1} Tape 

lERt^r device type; Z 

Bofejsjr. Infe'^cmi^t -a^^Jce^^ 0€ thi^ system {<S^^«i}a.tw^*feKC*cl} ; 

B»t«r infeeraet address ot r-emot^ t^p& system 
i( d.'$ ^■^Lvt 1 i: '»ia ♦ 1> ^ fi , d: > t 

Snter name of file to boot <de:fatJlt~/usr/boot/»ttiJi.i3{:.S40<J0) : 

Oeing- 1^ ^ddffa^$ X92*3*3.4 * C0090304 

BOOtt t df tp - #i i *!/!)/ Via !cr/t»^/iti$t ail 
Siitrs^'i OxfdOSOOOO 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 
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Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self -tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

( R<:aj(> "■S:eti^inv itta-ialled' 0"'^ ' " '" ' ' ' "' " ) 

The system will ask if you want to re-install if INSTALLED is not 0. 

histall the OS/MP 4. IB CD-ROM disk into the CD-ROM drive. 

To load the ramdisk on S4000 systems, using a local CD-ROM drive, enter a boot 
command of the following form: 

The bootROM copies the ramdisk image into memory and boots it: 



X ^jgat 0O3gea0O0-t>OK:43bgfo84>QxSO9ag ^ 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk from an image area of the OS/MP 4. IB contained on a remote disk 
accessed over the network. The command to load the ramdisk depends on the type 
of system. 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

(jEia;:ai!l!>''^^^^^^ '''''" . ) 

The system will ask if you want to re-install if INSTALLED is not 0. 
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If you are installing using a remote CD-ROM drive (via the network), install the 
OS/MP 4. IB CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 






The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192.1.3.42 and 
192.1.3.17. Also, the local machine must be listed in /etc/hosts, or in the NISAT 
hosts database, and in /.rhosts on diskhost. In addition, the ethemet address 
must be in /etc/ethers, or in the NISA^ ethers database. 

diskhost must have /cdromin it's /etc/exports file, and must also be 
nmning the rpc .xnountd(8) n£sd(8) and raxpd() daemons. 

Since tftp(l) will be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 



Q 



tftp dgram ndp wait root /uar/etc/i.n,tftpd in^tftpd ^& 



If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes wiU be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

/^jskho:&t # ps a^K 1 ^£.&p itt.etd ' " "^ 

24S '? X OtOl Inetd 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above ou^ut, pid is 249. 

(digkfeOj3t# kllX ^iiOg pid" . j 

Enter the following boot command: 
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Diskfiil Installation 

This section describes the procedure for installing diskfiil systems. 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a list of supported terminals is displayed 
as follows: 



^■' UQ ■ • ""^ "^ ^"^ 

It) Btu$L 
3) lap 

6} vtHOO 

If a frame-buffer is being used as the console, select the 4, the sun terminal type. 

If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



Do yott want to re-^iiistall the system (^yea^^ "^no* ^ or ^:?^ 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. If the message 
appears, enter yes to re-install the mandatory system software. 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 



/^amdlik" 



1} Ci^4m$e Pi^Jc l^sptitiOTiiwcf 

4) Rabaot Syatem 
SJ Bjult System- 
Sinter- »ttinber of tnnotton t-o execwt^: (^l'+*"*S''^ or ^l'*' for 
Vt t^i-pr> __^ . ^ 

The provided functions are described below: 

Change Disk Partitioning - Allows changing the sizes of disk partitions, and what 
those partitions are to be used for, such as filesystem, swap, or unused. 

• • • NOTE • • • 

If changes are going to be made to the disk partitions on which OS/MP 4. IB will 
reside, make the changes before installing software. Disk partitions not containing 
OS/MP 4. IB can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
boume software distribution, such as X Windows. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the fonnat(8) command. If they are, you must then 
select Change Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts the UNIX operating system after software installation. Al- 
ternatively, you may reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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You can request help at any ramdisk prompt by entering a question mark by itself. 
Table 16 shows edit commands available when entering text in response to 
prompts: 

Table 16. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


AU 


erase input line 


^R 


redisplay input line 


AW 


delete input up to 7* or whitespace 


^C 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return (^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as *co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with "System error" or "Internal error" and ending with a" #" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 






. 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactly that problem). In the event of a fatal error during software 
installation, please report the problem to Solboume customer support. 

Install Software 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes arc made lo the system until all information has 
been provided. 
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There are three information gathering menus: 

D Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

n Media Identification - Determines the installation media fiom which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

□ Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. 

Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Normally, no changes need to be made at this menu. To proceed to the Tape Iden- 
tification Menu, enter continue. 

Use the following steps to assign the /var filesystem to sdOd, rather than using the 
default of /var being a subdirectory of the root filesystem. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskful system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 35, the notation ' '(required)' * appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any partition of any disk. 
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St^^<Jj&};<3t ^il=etsy4t.fem £>fi!fi4iiti«>ft 



2) aw&f> an 8<JG1j (teqitited) 

4) /vair <i*» toot gfflkjctittioft. 
^) /trap en root partition 






Diak £axt.ltianj& (sizes in MB)^ 

a.4 32,4 151,1 9.3 

&.4 32 ♦ 7 i^C*» 9*-$ -— 



<0 

141.1 



ih) 



^cant3el* ^ ov '"^* for helpt 



V,_ 



Figure 35. Sample Standard Filesystem Definition Menu 
To modify the /var filesystem, enter the number: 4. 



_y 



JSnt-ex ni^mber of filB^ysfcem to change C^l' * < ^5*'3y 



The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 



BJoter n«jtte Qf <3i$H p:a:?:titi»a or ljostfj>^th for /y^?r 
£il^3ystemjr ^none''^ ^C^ or'^l" for helpi sdOd 



The new arrangement is displayed as shown in Figure 36. 

Once all changes for the standard filesystems have been made, enter continue 
to proceed to the Media Identification Menu: 



EtLt&x. xitaanber of filesystem to cbange •( ^l' . - "^SM ^ 



Installation Media Identification Menu 

The Media Identification Menu describes which media type (tape, CD ROM, or 
network directory) wiU be used during the installation. 

On Series S4000 systems, the default values are determined by how the ramdisk 
was booted. 
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4 J /Vdt On sdOti 

5) /tnup on root p^jctition 

(^)= m (cj ((S) <*) ^f) i^) ■ (fe) 

s<JQt 8*4 32.4 19^1.1 S*3 ™ 141*1 — - 

edli $*4 52^1 ISkO,^ $*^ 140»$ 



■^cetncBl'', ar ^^^ for help-: 



V 



Figure 36. Modified Standard Filesysiem Definition Menu 

Figure 37 shows the Media Identification Menu of a S4000 machine that was boot- 
ed from a local tape device stO (SCSI address 4). 

Local Tape Drive Installation 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to 'local- 
host'. The Installation media type must also be set to *Tape'. 

Remote Tape Drive Installation 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

The Local Internet address is the address of the system bemg installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Class C networks). A leading *0x' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 
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2) ID-dpe -drive ^ atO 
; 3 J Xocal Xn.t«m«t adar-ossi *^ <>,0.,0»0 ^3r«qwl5r$4 fos; sr^ifnote tape): 

5) ^BapB host: *? lacaihaafc {12'7.0,Q,1} 






VI* 



'4*)f ^ootitirt-w^", "pr^vio^aS 'cswuc^X'^ or ^^'tot: 



V 



Figure 37. Media Identification Menu - Local Tapehost 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Internet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 38 shows the Media Identification menu of a system loading software from 
a remote tape using tape device stl (SCSI address 5). 

When the details of the tape drive have been entered correctly, enter continue. 
You wiU be presented witii the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 

Local CD-ROM installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 39 shows the Installation Media Identifica- 
tion menu with the CD-ROM parameters set to install from CD-ROM. 

Network and remote CD-ROM Installations 

Installation media type must be set to Network 

Installation directory should be the full path name of the location of the installa- 
tion area, or the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /usr/cdrom, then the installa- 
tion path is simply /usr/cdrom. 
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Figure 38. Media Identification Menu - Remote Tapehost 
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Figure 39. Installation Media Identification Menu - Local CD-ROM 
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The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /.rhosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Qass C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the installation directory, 
which is used to determine it's Internet address. The name itself, however, is not 
especially important (it is discarded after the installation is complete). As such, the 
default name, tape-n-boot-serv, generally need not be changed 

When the details of the media have been entered correctly, enter continue. If 
You will be presented with the Package Selection Menu. If the operating system 
has already been installed, you will be prompted to insert the optional software dis- 
tribution media. 

Package Selection Menu 

Use the he Package Selection Menu to install optional Solboume software distri- 
butions. It provides a menu-driven method of examining the components of the dis- 
tribution tape, selecting the parts to be installed, and specifying the directories 
where the components will be located. 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, Solboume OS/MP Optional Software, is included on the OS/MP 
4. IB distribution tape. The following display shown in Figure 40 appears; the val- 
ues shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built fium scratch (overwriting any old contents) 
when the install command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 
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Figure 40. Package Selection Menu 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine the modules available, select the Optional 
Software package: 

■^iaai^all' ^ -or ^:?^ for h.elp-j t 

Should tim Scilbourae QS/V^ 4kIB Optional Software package 

The Should the Solbourne OS/MP 4. IB. Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu will appear as shown in Figure 41. 

7ir*7SrNOTE*** 



In Figure 41, the free KB reported varies depending on the type and size of disk 
drive installed. 
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Figure 41. Package Selection Customization Menu 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule's name. The column after the size indicates whether or not the module is cur- 
rentiy marked for installation. If the module is to be installed, the directory that tiie 
module's files are to be installed in is listed, followed by the free space on die par- 
tition that the directory refers to. 

Below are short descriptions of the mdividual modules: 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, libsuntool, and lib- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in section 6 of the UNIX User's Reference Man- 
ual. 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable fomi. See man(l), lookup(l), and qref(l) for more details. This option 
requires that tiie TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the NI- 
S/YP database services. 
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PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics tenninals. See 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book' '). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 

SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows will be used on 
the system. 

SYSTEM_^V 

System V-compatible libraries and executables. System VR3, POSDC, and 
5^0PEN are supported. See svidii(7v), svidiii(7v), xopen(7v), and posK(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text formatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vplot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are normally used for communicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System- V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TU 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 
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• • • NOTE • • • 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 



c 



Kilter jaxjjaber of laodixle t^ mnAxt^ C^l' ♦♦ ^15'!^, ^•continue'. 



The VERSATEC menu entry is highlighted, and: 



r — 



Jictdifyi»c|r the Vers^tec prititer sappo^t; modul© ^ 

Figure 42 shows the updated display. 



10} *PEX1* 
III VJeRSfATSC: 

1S> TLI 



1784 

^€ 

IMS 
4$ 






y 
• y 

y 
. y 
. 3? 
: y 
: y 

y 

y 

» 

y 

y 
y 

y 



/usr 
/u.sr 



e4«;47 

$4^47 
$464 7 
$4«4t 
64647 
$4^47 
64847 
£4647 

64647 
64647 
$4647 
64647 






Figure 42. Package Selection Menu - Deletion of Versatec Module 



• ••NOTE*** 

The free space for /usr has been increased by the size of the VERSATEC module 
as shown in Figure 42. 
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To install the GAMES module in /fun (on the root partition): 






The GAMES menu entry is highlighted, and: 

Shoul'd the <5iys!!EiS modtile tea: installed {*yes*, ■^«<>*'^ ^C^ o3c 

The menu is updated to reflect the change, as shown in Figure 43. 
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Figure 43. Package Selection Menu - Install Games module to /fun 



• ••NOTE*** 

The free space for /usr changes, and a completely new size (for /fun) is also dis- 
played as shown in Figure 43. 

If you decide to discard all changes made to the modules, use the command 
abort. This returns to the Package Selection Menu. 
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If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 



When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 44. 
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■^ 






Figure 44. Package Selection Menu 



Actual Installation 

Actual installation begins at this point, and may require from 10 minutes (if only 
mandatory root files are being installed and a local tape drive is used) to about two 
hours (if everything is being installed fix)m a remote QIC-150 tape drive). 

The steps taken during the installation are: 

1. extract miniusr. (This contains the installation software, as well as enabling 
swapping. The root disk might not be repartitioned after this step without 
requiring reinstallation.) 

2. create filesystems (root(/), /usr, possibly /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. create device entries 

4. install mandatory root files 

5. install mandatory kvm files 

6. install mandatory usr files 
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7. install optional software 

When installation has finished, the ramdisk menu is displayed (see Figure 45). If 
the installation failed, call Customer Support. 

Rebooting from the Ramdisk 

After a successful installation, start UNIX by rebooting as shown in Figure 45. 
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Figure 45. Ramdisk Menu 

Enter number of fimction to execute Cr..'5*, or '?' for help): 4 
At the Reboot System menu select Boot Unix: 



(^'ti^t^^ '^gX^ctidff' tiXfs^Sb^ yi^^^^ ) 
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After selecting 1, there is a short pause, and then: 

/Si^tOiftStic X>O0t fttiabie4- Type Cc«itK'<!>X**'C t;o ^ori: 
RjDM> boot 



\t^ ^ 

Now you must specify the system configuration information must be specified. 

Disabling tftp 

If the ramdisk was loaded from a remote tape drive, tftp(l) was enabled at that 
time. 

For security reasons, it should now be disabled on the system from which the tape 
was read. 

First, comment out the line, as shown below, in/etc/inetd.conf: 



#tffegt d^^sm. «dp wait root /■usr/«tc/i«>.tftpd in^tftpd 
/i:£tpi>oot 



Next, determine the process ID of inetd(8): 



24^ 7 X 0;OX iC0t4 



The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

Last, signal inetd to re-read the configuration file: 



3 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 
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Copyright. <c> 198^-1931 S"u» Microsystems* tno* and 



U**3 



A«toj»atic- reboot in pi;ogr63S ♦ * . 
1?Mr May a$ l$;$^;45 E^D^ 1?52 
cheCkiijgr qtjotaa : <Jo»« . 



fPhij3 3:y$i-$ttt fafl^ not ^^% h^^n OOnfigwr^ji* $$i'»^gt3re;JL y^iil&s^ . 
n-eed ta be «e:fe b^toxst the system Ga» c-ome vip to malti-'-user 

Kl^ist is it$ Xftte-JTftet 4<i<3,3r055 <(0 f?!>5P no«^i^ d.^£'^«lt » 

tsajat iis. the network b^ro^adcast ma.^'k ^defaslt ** Qx.tt£f£tQ0}1^ 
<He.tttm> 

iSfhat 1^ tli$ J!5X3- <i<t>mai3i ft.aitt$f ( ^non^' for noet^^ default >= 
^notte')? ltod«at;*CK)H <Biet»m> 



• • • NOTE • • • 
Using the default 'none' disables the NIS/YP services. 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfiilly come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, cycle the power off and on. 

• ••NOTE*** 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 



^SM> boot -^isi 



If the system booted successfully originally, you may instead log in as root: 






In either case, if a file exists that tells the system it has been configured, remove it: 

( # am /et!;g/ays^oQattf /b^ ) 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

CF<6^ifc ) 

Otherwise, use fastboot: 

( # /^to/f a^tboot ) 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing Diskless Clients on 
Sun and Solboume Servers 



The commands config_server and install_client automate the installation of disk- 
less clients. 

config_server sets up a prototype area for clients of a particular architecture (i.e. 
sun4CatOS4.1). 

install_client sets up a unique area for each individual client. 

You may set up a network in which cither a Solboume or a Sun acts as the server. 
The clients may be either Solboume or Sun systems. The clients need not be at the 
same OS release level as the server or each other. 

The necessary steps depend on your arrangement, and are discussed in the follow- 
ing subsections. 

1 Installing the correct config_server 

If the server is a Sun, or a Solboume not running OS/MP 4. IB or later you must 
install and configure a new version of config_server. 

If the server is a Solboume system running OS/MP 4. IB or later it already has the 
necessary version of config_server. Skip the "Installing config_server" subsec- 
tion and go to "Configuring the Server". 

2 Running config_server 

3 Running install_client 

4 Booting the client 

• ••NOTE*** 

An OS/MP 4. IB server can support any Solboume S4000, SeriesS, or Series6 cli- 
ents at OS/MP 4.1 B or Series4 at OS/MP 4.1 A3. It can also support Sun clients 
running SunOS. 

Installing config_server 

This procedure is necessary only for systems not mnning OS/MP level 4. IB or 
above. It can be used for any type of Sim or Solboume system. 

When using a local tape drive, install config_server using the following com- 
mands: 



4 t9X xp^ /4ev/3ft3a8feQ 
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When using a remote tape drive, the system name needs to be in the * 'tapehosts* * 
/.rhosts file. Install config_server using the following commands: 



(f xah "^xl tapehoat mt >^£ /dev/nrstcO as£ 5 >. 

I rail ^n t^p&host dd If^/idav/nrBtO bssSk | tar :gp&J? •" V ''^ 

In this example, you should replace tapehost with the actual name of your tape 
host machine. 

• ••NOTE**^ 

Some older versions of SunOS do not support the 'asf request for mi. If this is the 
case for your tape host, first substitute 'rew' for 'asf 5' in the above example, and 
then re-execute mt with fsfS' instead of 'rew' . 

When using a local CD-ROM drive, install config_server using the following 
commands: 



/4'»Mi»' /cdffCMitt' 






N 4 tag aqp£ /cdrcHat/^oola *t:ar 



When installing over the network, or when using a remote CD-ROM drive, first 
you create a mount pomt directory (if one doesn't exist), and mount the CD-ROM 
drive on the remote machine, referred to here as nethost, as follows: 






The system name needs to be in the ' 'nethosts" /.rhosts file. Install config_server 
using the following commands: 



In this example, replace nethost with the actual name of the remote host ma- 
chine, and replace cdrom with the actual path name or mount point. 



1 62 Installing OS/MP 4.1B on a Server 



Configuring the Server 

The command config_server installs executables on the server for use by one or 
more client systems. The executables are placed in /export directories, as de- 
scribed below. Since the /export directories may grow to be quite large, you may 
wish to have /export be a Unk to a file system with more space, for example: 

If you wish to use a directory other than /export, set the environment variable EX- 
PORT_DIR to the directory that you desire: 

When installing from tape, config_server prompts for a carriage return, which you 
enter after loading the tape containing the required files for the specified architec- 
ture. 

config_server accepts several options and arguments. The following are the most 
commonly used: 

n The -f option specifies the tape drive from which the software will be loaded 
onto the server. In the examples, /dev/nrstO is the value used. When accessing 
a remote tape drive, use a value of the form tapehostitapedrive. 

If the software that will be loaded onto the server is from a CD-ROM disk, or 
the mount point of the CD-ROM, the -f option specifies the pathname from 
which to read architecture-dependent directories. 

□ The -c option is used to specify a selected tape/on-disk configuration file. 

If you are using a CD-ROM disk or a remote system over the network, you will 
need to specify this option and one of the following four configuration files: 
s4000-cd, s4-cd, s5-cd and s6-cd. These configuration files contain the 
required root, usr and kvm tar files. They also contain the optional tar files for 
4. IB and/or 4.1 A.3, and may be added by editing the corresponding 
configuration file and taking out the "#" at the beginning of each line.. 

If the server is a Solboume, and the client is a Sun, use one of the configuration 
files in/usr/etc/setup corresponding to the architecture, operating system, and 
media of the client. You may also create a configuration file for any Sun tape 
or CD-ROM. Refer to the config_server(8) man page. 

a The -n option specifies the operating system and release level of the client 
systems, where these differ from the server. It is also used when clients with 
the same architecture are not all running the same release level. 

The values used may be any you wish, provided you are consistent when 
running the config_server and install_client commands. For example, you 
could use the values OS/MP.4.1 A, 0S/MP.4.1A.1, OS/MP.4.1 A.2, 
OS/MP.4.1A.3 or OS/MP 4.1B. 
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The result is to create subdirectories of /export named such that the machine 
type is the basename and the OS release is the extension. 

O client__arch, the final argument to config_server, specifies the machine 
architecture of the client, such as SeriesS, SeriesSE , Series6, S4000, sun4, 
sun4c, or sun3. 

Run config_server as many times as necessary to support the variety of machine 
architectures, operating systems, and release levels in use by clients on your net- 
work. 

A number of examples are presented here. For additional details, refer to the con- 
fig__server(8) man page. 

The first example configures a Solboume OS/MP 4. IB server for a SeriesS client 
also running OS/MP 4. IB. On the Solboume server enter the following: 

The next example configures a Solboume server running OS/MP 4. IB for a pair of 
Solboume S4000 clients, one at 4. IB and the other running 4. 1 A. 1 

Notice that the first invocation of config_server shown above did not use the -n 
option, by default supporting the client at the same release level as the server. The 
second example used the -n option, since the server and client are at different re- 
lease levels. 

The next example is for a SeriesS server which supports several Sun 4 clients, some 
running SunOS 4.1 and others running SunOS 4.0.3: 

/# /i33r/etsc/setup/eon£lgjaerv'e3? HS /d&v/^tstatM >m »jmos.4-5r' 

The last example is running config_server from 4. IB software on a CD-ROM disk 
for a Solboume OS/MP 4. IB server which supports Solboume S4000 clients, 
SeriesS clients, and Series6 clients respectively: 
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Replace cdrom with the actual path name or mount point on the local or remote 
host 

This concludes the examples of config_server. 

After running config_server, add the client to the /etc/hosts and /etc/ethers files, 
or the corresponding networic information services databases (NIS/YP). 

If the server is using NIS/YP, /etc/ethers and /etc/hosts must be modified on the 
master server. config_server does not update NIS/YP; this must be done manually. 

If the server is not using NIS/YP, the domain name must be set to *'none' ' forin- 
stall_client to work correctly. 

• ••NOTEtI^** 

/etc/ethers must not start with a blank line. 

Installing Clients 

The install_c!ient command installs the diskless client on the server. It creates the 
client's root filesystem under the server's /export/root directory, links the client's 
/usr to the appropriate /export/exec directory, and sets up the client's kernel-spe- 
cific files, such as /vmunix. After running install_client on the server, the client 
can boot as soon as the client's bootROM variables are set correctly. 

The install_client command accepts a number of options and arguments. The fol- 
lowing are the most commonly used: 

The -n option. If you used the -n option to config_server when setting up the serv- 
er for this client, be sure to use it in the same way when invoking install_client. If 
necessary, examine the subdirectory names in /export/exec on the server, when 
you find the relevant subdirectory, the portion of the name after the first dot is the 
value to use for the -n argument. 

The client argument identifies the name of the client being installed. 

The inachine_arch argument specifies the type of machine in the client, such as 
SeriesS, SeriesSE, Series6, S4000, sun4, sun4c, or sun3. 

Other options and ftirther details are discussed in the install_client(8) man page. 

The examples which follow parallel the server configuration examples. 

Example install_client Command Lines 

The first example installs a Solboume OS/MP 4. IB client (named ' 'rootbeer' ') on 
a SeriesS server which also run OS/MP 4. IB. On the Solboume server enter the fol- 
lowing: 
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The next example installs a pair of Solboume S400G clients, one running OS/MP 
4.1B C'rootbeer") and the other running 4.1A.1 ("lemonade'*), on a Solboume 
server running OS/MP 4. IB. 



Note that the first invocation of install_client shown above did not use the -n op- 
tion, by default placing the client at the same release level as the server. The second 
example used -n since the server and client are at different release levels. 

The next example is for two Sun 4 clients, one running SunOS 4. 1(' 'candybar' *) 
and the other nmning SunOS 4.0.3 (* 'popcorn' '), supported by a Solboume server 

Smi4 : 



• ••NOTE*** 

install_client modifies only the local letcIhooiparsLms. If the server is using NIS/- 
YP, /etc/bootparams must be modified on the NISIYP master server. 

This concludes the examples of install_client. 



166 Installing OS/MP 4.1B on a Server 



Installing OS/MP 4.1B on a seiver using reinst_sys 167 



Installing OS/MP 4. IB on 
a Server using reinst_sys 



This chapter describes how to install OS/MP 4. 1 B on a server using the new utility, 
reinst_sys, which allows you to upgrade your system with a full installation of 
the operating system on unused partitions of one or more disks, while staying up in 
multi-user mode. 

A server is a system that provides NFS disk services. 

The purpose of reinst_sys is to minimize downtime by performing a full in- 
stall of OS/MP onto a new system disk while the system continues to run an earlier 
version on an old system disk. Once reinst_sy s is complete, you are free to do 
whatever local modifications are desirable before booting from ttie new disk. 

For example, you might reconfigure the OS/MP 4. 1 B kernel or modify files of local 
interest such as /etc/printcap. Only when the new system disk is ready to run do 
you need to halt the old system and reboot from the new disk. 

Finally, unlike earlier full install releases, reinst_sy s makes it possible to fall 
back to the earlier version of OS/MP if there turns out to be some problem with the 
way you set up the new system. To fall back to the old system, halt the new system, 
change ROM variables DEFAULTROOT and perhaps DEFAULTSWAP, and 
then boot. 

• ••NOTE*** 

In order to use this utility, you must have an unused disk, or at least enough unused 
partitions, on which to install the OS/MP 4. IB release. You can not use reinst_sys 
to install over the currently running disk partitions. If you do not have an unused 
disk for reinst_sys to use, you will have to install OS/MP 4. IB from scratch, while 
the system is unavailable to your users, as was done in previous OS/MP full instal- 
lation releases. 

You should not install on a disk connected to a channel board as it will be impos- 
sible to boot from that device. 
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Before Installing... 



Extracting reinst_sys via a 
Local Tape Drive 



• • • NOTE • • • 

Before using reinst_sys, you must know what disk(s) and partitions you want to in- 
stall on. If changes need to be made to any of the disks partitions, you must do this 
prior to running reinst_sys. Use partitionf^j to modify the disks. 

It is best to select a disk that will be recognized by an OS/MP 4.1 B generic kernel. 
Otherwise it will be necessary to recorfigure the kernel (which may be desirable 
anyway) before rebooting. This is discussed in more detail at the end of this sec- 
tion. 

• • • CAUTION • • • 

If installing by tape, clean the tape drive on the machine you will be using be- 
fore installing the release tape. Failure to do so may damage the release tape. 

To ran reinst_sys, it must first be extracted from the OS/MP 4. IB media. 

The following explains four different methods of extracting r e in s t_s y s into the 
/usr/etc directory. You must be logged in as root 



N ^eXlyt tar x|>£" / day/a rg-t-0 i£Bin.s-t_syf& 



Extracting reinst_sys via a 
Remote Tape Drive 



Routing from the system being installed to the tapehost must exist Refer to the Sys- 
tem Network and Administration Guide {1014SI). The local machine, telly in 
this example, must be listed in /etc/hosts, or in the NIS/YP hosts database, and 
/ j*hosts on t apeho s t. 
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Extracting rcinst_sys via a 
Local CD-ROM Drive 



Create a mount point directory (if one doesn't exist), mount the CD-ROM drive, 
and extract reinst_sys as follows: 

t^llyi fid' /ii^ii^/stc 



Extracting reinst_sys via a 
Remote CD-ROM Drive or the 
Networic 



Create a mount point directory (if one doesn't exist), and mount the CD-ROM 
drive on the remote machine, referred to here as diskhost, as follows: 






The local machine must be listed in /etc/hosts, or in the NIS/YP hosts database, and 
in /j*hosts on diskhost. 

diskhost must have /cdromin its /etc/exports file, and it must be exported 
(see exportfs(8)). diskhost must also be running the rpc.inountd(8) and 
nfsd(8) daemons. 

On the local machine, create a mount point directory (if one doesn't exist), mount 
the remote directory, and extract reinst_sys as follows: 



i^^iijiri fBk<3ijr /c<lrCTO 
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Installing... 



This section covers the 4.1B installation on SeriesS, SeriesSE, Series6 and S4000 
systems. 

During installation, you can request help at any prompt by entering a question 
mark. Table 17 shows edit commands available when entering text in response to 
prompts: 

Table 17. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


AU 


erase input line 


^R 


redisplay input line 


AW 


delete input up to 7' or whitespace 


^ 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


AL 


redisplay entire screen 


return C^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the beginning of the 
string is displayed as ** . . . ". This allows display of the end of tiie string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co* for 'continue'), ex- 
cept for *yes' and 'no*, which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a '*#" 
prompt If a fatal error occurs, software installation may be restarted by entering: 






^^ 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix exactiy that problem). In the event of a fatal error during software 
installation, please report the problem to Solbournc customer support. 
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Installing Software 



Installing software has two distinct stages: gathering infonnation and modifying 
the system. No pemianent changes are made to the system until all infonnation has 
been provided. 

There are three inftjrmation gathering menus: 

n Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /imp) are located. 

D Media Identification - Determines the installation media from which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

a Package Selection - allows selecting of which optional software packages are 
to be installed. 

All three menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the shell tenninating reinst_sys. 

previous always returns to the previous menu (which is the shell, in the case of the 
Filesystem Definition menu). The changes discarded in this case are those made in 
the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system, even if the system actually contains a disk. You 
can add entries for any local disks to /etc/fstab after installing the system as a disk- 
less client. 

Any changes made to die standard filesystems with partition(8) will appear in this 
menu. 

reinst_sys has the following options: 

reinst_sys [-m] [-n] [-r/root^ath] [-fhost:/device^ath] [-a arch] 

-m Don't mount or newfs filesystems 

-n Don't newfs filesystems 

-r /root/path Pretend /root^atii is really / 

-f host:/device/path What tape device to use 

-a arch What cpu architecture to use - overrides cpustatus 
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In general, you will not need to use any of these options except perhaps the -a op- 
tion. The -f option will be set while running reinst_sys. 

The -a option is to be used when you are upgrading or changing the architecture of 
your machine. Suppose you have a machine with SeriesS CPUs, and you want to 
upgrade to Series6 CPUs. To install the OS/MP 4. IB for Series6, log in as root and 
issue the following command: 

To install OS/MP 4. IB with no change in architecture, log in as root and issue the 
command: 

reinst_sys begins by reading the current /etc/fstab file to determine the disks 
attached to your system (mounted disks are also probed). 

After examining all attached disks, reinst_sys presents the first menu, the 
Standard Filesystem Definition menu. 

The root, swap, and usr partitions are required and must be defined before going to 
the next menu. The swap will be defined as the current swap area, and may be re- 
defined if you wish. The root and usr areas need to be defined from the currently 
available disk partitions that are highlighted in the Standard Filesystem Definition 
menu. For a disk partition to be available for use in reinst_sys, it must not be 
currently mounted, and it must not have an entry in the /etc/fstab file. 

Example: 

Currently, the root(/) filesystem is on sdOa, swap is on sdOb, and the /usr filesys- 
tem is on sdOg. Available partitions are highlighted. If the necessary partitions are 
not available, exit reinst_sys. A partition may not be available because it is 
mounted or an entry exists for it in the /etc/fstab file. Also, it may not be available 
because it does not exist, or it is not large enough, in which case you will need to 
run partition(8) to repartition the disk as needed. 

Use the following steps to assign the root (/) filesystem to sd2a, the /usr filesystem 
to sd2g, and the /var filesystem to sd2d (rather than using the default of /var being 
a subdirectory of the root filesystem). Leaving swap on the disk may be desirable. 

The steps for changing /var are optional. This makes use of partition d, thus using 
9.5 MB of disk space that is not used when the default disk partition is used with 
the standard filesystem definition. 

In Figure 46, the notation ' '(required)" appears next to the root(/), swap and /usr 
filesystems. These filesystems must be defined; however, they may be placed on 
any sufficiently large available partition of any disk. 
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Figure 46. Sample Standard Filesystem Definition Menu 
To modify the root (/) filesystem, enter the number 1. 

The root menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2a. 

To modify the /usr filesystem, enter the number 3. 

The usr menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2g. 

I5iit«r"jiama of di&Jc pactitio» or ho5it.**p«tl5 tor- /u9X 
To modify the /var filesystem, enter the number 4. 

^Gontiwie'r ^p-x^viottsS ^Q^nc&X^ or ''t*^ for haXpi 4 
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The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sd2d. 



r 






The new arrangement is displayed as shown in Figure 47. 
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Figure 47. Modified Standard Filesystem Definition Menu 



Once all changes for the standard filesystems have been made, enter continue 
to proceed to the Installation Media Identification menu. 



Installation Media 
Identification Menu 



The Installation Media Identification menu describes which media type (tape, CD- 
ROM, or network directory) wiU be used during the installation. Figure 48 shows 
the Installation Media Identification menu. 
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Installing from a Tape Drive 



Figure 48. Media Identification Menu - Local Tapehost 



Installing from a local tape drive requires that the Installation media type be set to 
Tape, the tape drive field be set to either stO or stl (the only supported tape 
drives) and that Tape host be set to localhost. 



Installing From a Remote Tape 



Installation media type must be set to Tape. 

Tape drive should be the base name of the tape drive on the tapehost, eitiier stO 
or stl. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /jhosts file. Check /etc/hosts or the NIS/Y? 
hosts map as appropriate. 

The broadcast mask should not be changed unless your networic uses a non-stan- 
dard mask. Such a mask is used when a networic is sub-netted (i.e., a Qass B net- 
woric is treated as several Qass C networks). A leading *0x* is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape (rootbeer in this 
example), which is used to determine the tape host's Internet address. 
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Figure 49 shows the Installation Media Identification Menu of a system that is set 
up to install from a remote tape using tape device stO (SCSI address 4). 
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Figure 49. Installation Media Identification Menu - Remote Tapehost 

When the details of the tape drive have been entered correctly, enter continue. 
You will be presented with the Package Selection Menu. 



Local CD-ROM Installation 



Installing finom a local CD-ROM drive requires that the Installation media type be 
set to CD-ROM, the CD drive field be set to /dev/srO, and the CD host field be 
set to localhost. 

Figure 50 shows the Installation Media Menu witii the CD-ROM parameters set to 
install firom CD-ROM. 



Netwoik and remote CD-ROM 
Installations 



Installation media type must be set to Network . 

Installation directory should be the full path name of the location of the installa- 
tion area, OR the fiill patii of the CD-ROM mount point, on the network host. 
Figure 50 shows the installation directory as /usr/locaJ. /install/ 4 . IB 
on the host rootbeer. If you are installing from a remote CD-ROM mounted on 
/usr/cdrom, for example, then the installation directory is simply /us- 
r/cdxom. 
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Figure 50. Installation Media Identification Menu - Local CD-ROM 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /jhosts file. Check /etc/hosts or the NISAT' 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a netwoik is sub-netted (i.e., a Qass B net- 
work is treated as several Class C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading *0' is needed for octal numbers. If 
neither prefix is given, the value is assiuned to be in decimal. 

Network host must be set to the name of the system with the installation directory 
(rootbeer in this example), which is used to determine its Internet address. 

Figure 51 shows the Installation Media Menu with the values set for a network in- 
stallation 

Once the details of the media have been entered correctly, enter continue to pro- 
ceed to the Package Selection Menu. 



Package Selection Menu 



Use this menu to install optional Solboume software distributions. It provides a 
menu-driven method of examining the components of the distribution tape, select- 
ing the parts to be installed, and specifying the directories where the components 
will be located. 
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Figure 51. Installation Media Identification Menu - Network 

The components of a distribution are referred to as packages. Some examples of 
packages are FORTRAN 1.4, X Windows, and Solbourne OS/MP Optional 
Software. Packages contain one or more modules, which are groups of logically- 
related files, such as executables or libraries. Most packages also have variables, 
which have two uses: controlling the actions of installation commands associated 
with the package, and prefixing where modules are to be installed. 

A single package, OS/MP 4. IB Full-Install Optional Software, is included on the 
OS/MP 4. IB distribution tape. The following display shown in Figure 52 appears; 
the values shown for Size in this and subsequent displays may vary. 

The message Mandatory Software Will Be Installed indicates that 
the standard filesystems will be built from scratch (overwriting any old contents) 
when the InstaLLl command is issued. If this message does not appear, only the 
packages selected in this menu will be installed. 

The Optional Software package contains a set of software modules that have his- 
torically been installed as part of /usr. These modules are not necessary for the ba- 
sic operation of the system, and have been provided separately so that /usr may be 
kept as small as possible. To examine tiie modules available, select tiie Optional 
Software package: 






Utlstflsll' 



or 



SJiouId. tM ^B/i^ 4* IE Ful3,-»Iu8tall OptidMl Software 
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Figure 52. Package Selection Menu 

The Should the OS/MP 4. IB Full-Install Optional Software 
package be installed question refers to the package in general. The mod- 
ules are individually selected for installation on the customization screen, and by 
default all are selected for installation. 

After replying yes, the customization menu will appear as shown in Figure 53. 

• ••NOTE*^* 

Figure 53 is only an example. The free KB reported varies depending on the type 
and size of disk drive installed. 

The size of each module in kilobytes is listed immediately to the right of the mod- 
ule's name. The column after the size indicates whether or not the module is cur- 
rentiy marked for installation. If the module is to be installed, the directory that the 
module's files are to be installed in is listed, followed by the free space on the par- 
tition that the directory refers to. 

Below are short descriptions of the individual modules: 

DEBUGGING - program debugging aids 

This module contains the debugging tool dbx(l) and the profiled versions of the 
standard libraries libc, libcurses, libm, libtermcap, libtermlib, hbsuntool, and hb- 
sunwindow. 

GAMES - games and demonstration programs 

The recreational programs listed in Section 6 of the UNIX User's Reference Man- 
ual. 
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Figure 53. Package Selection Customization Menu 

MANUAL - on-line manual pages 

Sections 1 through 8 of the UNIX User's and Programmer's Manuals in machine- 
readable fonn. See man(l), lookup(l), and qref(l) for more details. This option 
requires that the TEXT option also be installed. 

NETWORKING - network utilities 

Utilities and commands that access a network, such as rcp(l) or ftp(l). This mod- 
ule is required on systems that are connected to a network, or that will use the Nl- 
S/YP database services. 

PLOT - basic plot-generating applications 

The standard UNIX plotting utilities, which allow the creation of plots and graphs 
from simple data to be displayed on a variety of plotters and graphics terminals. See 
plot(lG) and graph(lG). 

SECURITY - C2 security 

The SECURITY module provides features such as audit trails and shadow pass- 
word files in the spirit of the Department of Defense's C2 Security Specification 
(the "Orange Book"). The compliance of these features has not been certified. 

SV_PROG - Sun View program development support 

Include files and libraries needed for compiling SunView applications. This mod- 
ule requires that SV_USER also be installed. 
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SV_USER - basic SunView support 

The SunView windowing system and associated applications (such as suntools(l) 
and shelltool(l)). This module is not required if only X Windows wiU be used on 
the system. 

SYSTEM_V 

System V-compatible libraries and executables. System VR3, POSIX, and 
^^OPEN are supported. See svidil(7v), svidlii(7v), xopen(7v), and posix(7v) for 
details. 

TEXT - nroff/troff text processing 

This module provides the text foraiatter troff(l) and its associated support pro- 
grams and files. This option is required if the MANUAL option is installed. 

VERSATEC - Versatec printer support 

Various utilities specific to Versatec printers, such as vtroff(l) and vpIot(lG). 

UUCP - uucp applications suite 

uucp(lC) and its support programs. These are nomially used for commimicating 

with other UNIX operating systems via phone line. 

RFS 

Utilities and libraries to support the System V Remote File System. 

SHLIB 

Position-independent versions of the BSD and System-V versions of the C library. 
These are provided to allow substituting or adding a module to the shared C library. 

TU 

Libraries and headers to support developing programs that take advantage of the 
System V Transport Layer Interface. 

Modifying a module allows selecting whether or not it is to be installed and, if so, 
the directory its files are to be extracted into. 

• ••NOTE*** 

All modules are intended to be extracted in their default directory. If a module is 
extracted somewhere else, there is no guarantee that the programs provided in the 
module will work. 

For example, to not install the VERSATEC module: 

^^afc>oct^> OF "?* fox- 'h^l-^x \l ) 

The VERSATEC menu entry is highlighted, and: 

>dlfyi?ig tiie Ver3at:«G print^sr support mpduXe 

s ^g "^^^ for faiglp}? no 

Figure 54 shows the updated display.: 
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Figure 54. Package Selection Menu - Deletion of Versatec Module 

• ••NOTE*** 

The free space for In'sc has been increased by the size of the VERSATEC module 
as shown in Figure 54. 

To install the GAMES module in /fun (on the root partition): 



'abort^^ or ^7^ tot: h^lpt 2 



The GAMES menu entry is highlighted, and: 



/Modifying the cfamaa atud desaonstratlon prograais module "^ 
^bo-«ld tiie ^M^S module be installed ( '^yes^ , ^»o' r "^C^ oc 

liiAtSttl GAMES ift.whai <|iite.i5t^0i?y? /fua. 

/futi does Jiot exls^t* Create it ditria^f installatioii t^yes^ 

The menu is updated to reflect the change, as shown m Figure 55. 

* * * NOTE * * * 

The free space for /usr changes, and a completely new size (for /fun) is also dis- 
played as shown in Figure 55. 
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Figure 55. Package Selection Menu - Install Games module to /fun 

If you decide to discard all changes made to the modules, use the command 
abort. This returns to the Package Selection Menu. 

If you are satisfied with the changes (if any) made to the modules, enter the com- 
mand continue. This will record the changes and return to the Package Selection 
menu. 

When package customization has been completed (which may mean no packages 
were selected for installation), enter install as shown in Figure 56. 

The actual installation begins at this point The steps taken during the installation 
are: 

1. create filesystems (root(/), /usr, possibly /var or /tmp 

2. create device entries 

3. install mandatory root files 

4. install mandatory kvm files 

5. install mandatory usr files 

6. install optional software 
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Figure 56. Package Selection Menu 

When installation has finished, it gives the following message: 

Press aay character to contiRue 

The next display gives the values of the previous and new ROM variables DE- 
FAULTROOT, DEFAULTS WAP (if they have changed), and asks if you want to 
update the variables, as shown in Figure 57. 

• ••NOTE*** 

Before you say 'yes', make sure that all the previous settings of these variables are 
recorded so that you can later reboot from the old version of the system if neces- 
sary. If you choose not to update the ROM variables, make sure that you record the 
new values and use them to reboot the newly installed system at a later time. 

reinst_sy s then perfonns the final system setup, and completes. The new sys- 
tem's filesystems are currently mounted under the /etc/sys_conf/reinst_sys/root 
directory. For example, the new version of the /var directory is mounted at /etc/sy- 
s_conf/reinst_sys/root/var. 

At this point, the newly installed system is ready to boot. However, you may want 
to finish the installation by creating or editing such files as /etc/rclocal, auto- 
mounter maps, /etc/printcapv the /var/spool directories, NISAT maps, or any oth- 
er files local to your system. If you have comments in your /etc/f stab file, they will 
not exist in the new /etc/f stab file, so you may want to edit this file. 
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Figure 57. Update ROM Variable 

• ••NOTE*:A:* 

If you installed the new system on a disk that is not recognized by a OS/MP 4. IB 
generic kernel, then you must reconfigure the kernel before rebooting. 

You may also wish to create a customized kernel on the new system, so that hard- 
ware such as the channel board and VSCSI devices will be recognized. If you 
would rather wait until after rebooting the new system to configure your kernel, 
you should edit the new /etc/fstab file and comment out any partitions which are 
on disks not visible to the generic OS/MP 4. IB kernel. 

After you have completed customizing the new installation, reboot your machine, 
using the new ROM variables. 

If you used the -a option to upgrade to a different architecture, then after custom- 
izing the new installation, halt the machine and turn off the power. Replace the old 
CPUs with the new CPUs, power up and boot your machine using the new ROM 
variables. 
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Before Installing... 



Installing... 



Installing OS/MP 4. IB 
on a Dataless Client 



This chapter describes how to install OS/MP 4. IB on a Dataless Client. 

A dataless client is a machine whose /usr files are NFS-mounted from another ma- 
chine (the * 'server' ') but whose root partition is on a local disk. 

• • • CAUnON • • • 

Perform a full backup before installing OS/MP 4.1B. A complete installation 
will overwrite all information on the disk partitions specified for the root (/), 
swap, /var, and /tmp filesystems. 

Before installing the release tape, you must clean the tape drive on the host 
machine. Failure to do so may damage the release tape. 



Loading the ramdisk image is your first step in a diskful installation. The ramdisk 
image is a special UNIX operating system kemel with a built-in ramdisk that con- 
tains the installation software. The command to load the ramdisk depends on the 
type of system. Follow the instructions for your system type. 



Installing on a Series5, 
Series5E, or Series6: 



Loading the Ramdisk 

Tum the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 
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Loading the Ramdisk via a Local Tape Drive 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 

(>DM> g^te^v in$tall^d 3 

The system asks if you want to re-install if INSTALLED is not 0. 

To load the ramdisk on SeriesS or 5E systems using a local tape drive, enter the fol- 
lowing boot command: 

(^#:o^l>(>ot »t.M|/a^^ ^ 

To load the ramdisk on Series6 systems using a local tape drive, enter the following 
boot command: 

The variable TapelD shown in the command should be replaced with the SCSI ID 
of the tape drive to be used. For stO, use 4; for stl , use 5. 

The bootROM copies the ramdisk image into memory and boots it: 



/foot?' 3t*^ll,4r3| 






The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. 

Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following example, 
must be on the same network as the system being installed, referred to as hamster 
in the following example. For example, with a class C network, the first three num- 
bers in the Internet addresses of the two machines must be the same, such as 
192.1.3.42 and 192.1.3.17. Also, /i«/7wrer must be listed in /etc/hosts, or in the NI- 
S/YP hosts database, and /.rhosts on tapehost. In addition, the ethemet address 
must be in the ethers database. The ramdisk must be extracted from the OS/MP 
4. IB distribution tape onto a disk on tapehost. 

Since the system uses tftp(l) to load the ramdisk image, it must be enabled on the 
tapehost. Examine the file /etc/inetd.conf. A line similar to the one below should 
be in the file: 

t£1;|) <agrAm udp wAits root /uar/etc/inVtftpd iaVtftpd -^s 
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If the line starts with a #, remove the #. 

If a - s appears after the last i n . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 Mbytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

\ ^ $41 p3 R <^pQO ^^^^P li^^t4 [ / 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

Put the distribution tape into the drive and execute the following commands. 

tapehost must also be running rpc . mount ed(8) n£8d(8) and rarpd(8) 
daemons. 

• ••NOTE*** 

In the following example the install kernel will be named /var/tmp/ install. The ac- 
tual name of the file is not important, as long as it is used consistently here and in 
the example on the next page. Also note that thefilesystem must have enough space 
to /told the install kernel. 

In the mt command below, replace the variable X with one of the following values, 
depending on the type ofsystem: 

Table 18. 



System 


Value of X 


SeriesS and 5e 


2 


Series6 


3 



For Exabyte tape drives, use bs=1024 instead of bs=512 inthe dd command shown 
below. 



190 Installing OS/MP 4.1B on a Dataless Client 



Enter the following boot command: 

Q stiiA> h tLttp ■» ^1 ( f fhQ^ tnmatBr} /va r/tmp/ inana IX- '" ^ 

In the example above, the variable hostnumber should be replaced with the last 
of the four numbers in the system's Internet address. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. , 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to deteraiine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

The system will ask if you want to re-install if INSTALLED is not 0. 
Install the OS/MP 4. IB CD-ROM disk into the CD-ROM drive. 

• ••NOTE*** 

In order to boot from the local CD-ROM disk, the bootROMs must be at version 
5.5 or higher. 

In the two boot commands below, replace the variable X with one of the following 
values, depending on the type of system. 

Table 19. 



System 


Value of X 


SeriesS and 5E 


5 


Series6 


6 



To load the ramdisk on SeriesS, 5E, or 6 systems, using a local CD-ROM drive, 
enter a boot command of the following form: 

The bootROM copies the ramdisk image into memory and boots it: 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 
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Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk fix)m an image area of the OS/MP 4. IB contained on a remote disk 
accessed over the networic. The command to load the ramdisk depends on the type 
of system. 

Power on the system. After the system passes the self -tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to detennine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

The system will ask if you want to re-instaU if INSTALLED is not 0. 

If you are installing by a remote CD-ROM drive (via the network), install the 
OS/MP 4.1B CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 

The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C networic, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192.1.3.42 and 
192.1.3.17. Also, the local machine must be listed in /etc/hosts, or in the NIS/YP 
hosts database, and in /.rhosts on di skho s t . In addition, the ethemet address 
must be in /etc/ethers, or in the NIS/YP ethers database. 

diskhost must have /cdrom in it's /etc/e3cports file, and must also be 
running the rpc .mountd(8) n£sd(8) and rcLxpd(8) daemons. 

Since tftp(l) will be used by the system to load the ramdisk image, it mtist be en- 
abled on the diskhost. Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 

(t£tp dgrrajfl u4p wait rocit /ttsa^/fttc/in^titpd in^tftpd «-» ~\ 
/tj?t|>tiq^t , ,. J 

If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes wiU be needed in the directory used. 
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If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

^iskhic^st # pa ax: I ^gr^p in^td ^ 

\ ^ •S4!l p3 E OiOO eg'rep irtatd. ' . ^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above ou^ut, pid is 249. 



( di$ikh<^i^^# >ili' -^^RW pM '"~^ 



D 



In the boot command below, replace the variable X with one of the following val- 
ues, depending on the type of system 



Table 20. 



System 


Value of X 


SeriesS and 5E 


5 


Series 6 


6 



Enter the foUowmg boot command: 

The bootROM copies the ramdisk image into memory and boots it: 

X ^JLiK^ : OOx^a.0OO^(^kA$b$^jB>fOx$a^gO ^ 

A spinner is displayed while copying the ramdisk into memory. When the copy 
completes, there is a pause of up to three minutes. 
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Dataless Installation 

After Booting Ramdisk 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a terminal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a hst of supported terminals is displayed 
as foUows: 

/I) €10 ' " 

%) hp 

4) aart 

6) vtlOO 

Vs WI)ia.t type of termijoaX are .yo<^ tt&litg' P3t^ «.*^7^)'^ ^ 

If a frame-buffer is being used as the console, select the 4, the sun terminal type. 

( TSfaat:. t3?pa 0f temiim '^f^^..^^.^'^9..\'^^*.**'^^^^^ } 

If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



Do ycyvt.w-a&l; to i:a"*inistall tfee S3f3tej» t^^^a^^ ^no% or *'?' 

The above message is for the benefit of users intending to re-instaU the system soft- 
ware, but have not reset the INSTALLED environment variable. 

If the message appears, enter yes to re-instaU the mandatory system software, or 
no to continue the installation without re-instaUing it 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 

/HMf&i^'k — — " ' X 

i> CJiaage Disk Part.i.tiDiiln.9 
2} lfi.$li^ll Software 

W^-p) ^ [ y 

The provided functions are described below: 

Change Disk Partitioning - Allows the changing of the sizes of disk partitions, 
and what those partitions are to be used for, i.e. filesystem, swap, or unused. Refer 
to the Changing Disk Partitions Section for details on changing disk partitions. 

• ••NOTE*** 

If changes are going to be made to the disk partitions on which OS IMP 4. IB will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4. IB can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
boume software distribution, such as X Windows. See ' 'Software Installation fi-om 
the Ramdisk,** for more information. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the fonnat(8) command. If they are, you must then 
selectChange Disk Partitioning before attempting to Install Soft- 
ware. 

Reboot System - Starts UNIX after software installation. Alternatively, you may 
reload the ramdisk from scratch. 

Halt System - Returns control of the system to the bootROM. 
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Help may be requested at any ramdisk prompt by emering a question mark by itself. 
Table 21 shows edit commands available when entering text in response to 
prompts: 



Table 21. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


'^U 


erase input line 


AR 


redisplay input line 


AW 


delete input up to 7' or whitespace 


^ 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


AL 


redisplay entire screen 


return C^M) 


end input 


newline i^S) 


end input 



If a string is too long to be displayed m the available space, the beginning of the 
string is displayed as "... ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as 'co* for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with "System error" or "Internal error" and ending with a" #" 
prompt If a fatal error occurs, software installation may be restarted by entering: 






where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix that problem). In the event of a fatal error during software instal- 
lation, please report the problem to Solboume customer support. 

Software Installation from the Ramdisk 

Installing software has two distinct stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 
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There are three informational menus: 

D Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

a Media Identification - Determines the installation media fi-om which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

n Package Selection - allows selecting of which optional software packages are 
to be installed. 

All tliree menus provide the command cancel. The first two also provide the com- 
mand previous. These commands allow you to return to prior menus, optionally 
discarding any changes that have been made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since Install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from that menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. The /usr files should have already been installed on liie server. 

Any changes made to the standard filesystems with the partition tool wiU appear in 
this menu. 

Changing an entry at the Standard Filesystem Definition 

The following steps assign the /usr filesystem to rootbeer:/export/exec/Series5., 
rather than using the default of /usr being a subdirectory of the root filesystem. 

To modify the /usr filesystem, enter the number 3. 



Q 



The usr menu will be highlighted, and the system wiU request a disk partition. As- 
sign it to rootbeer:/export/exec/Series5. 

The new arrangement is displayed as shown in Figure 58. 

The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a subdirectory of the root filesystem. 
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These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskiiil system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 

In Figure 58 shown below, the notation *' (required)" appears next to the root(/), 
swap and /usr filesystems. These filesystems must be defined; however, they may 
be placed on any partition of any disk. 

$)f /war OP w>ot'1?<5'e:37?/■e«£iOJ^t:■/>e«.^<?/^$a?ifti5^ir^ 

(A^ im <«> m (^j m t^} . m 

BdOr 3.4 32*4 iai*l ^.3 141.1 






Figure 58. Sample Standard Filesystem Definition Menu for Dataless Clients 
To modify the /var filesystem, enter the number 4. 






3 



The var menu will be highlighted, and the system will request a disk partition. As- 
sign it to sdOd. 

The new arrangement is displayed as shown in Figure 59. 
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Figure 59. Modified Standard Filesystem Definition Menu for Dataless Clients 

Once all changes for the standard filesystems have been made, enter continue 
to proceed to the Media Identification menu: 



c 



^ccaitita.ae*'* '^pr-evioa^*^^ ■* cancel ^^ o^r ^^' far Jbelpt coiitijJiiS' 



s^ 



r/je Media Identification Menu 

The Media Identification Menu describes which type of installation media will be 
used during the installation and where it is located. On Series5, SeriesSE, and 
Series6 systems, the default is to install from a local tape drive, even if no such 
drive exists. Therefore, changing the settings on a non-Series S4000 machines 
probably will be necessary. 

Figure 60 shows the Media Identification Menu. 

Installing from a Tape Drive 

Installing fiom a local tape drive requires that the Tape drive field be set to eitiier 
stO or stl (the only supported tape drives) and that Tape host be set to local- 
host. The Installation media type must also be set to Tape. 

Installing from a remote tape drive requires that all Uie fields be set: 

Installation media type must be set to Tape. 

Tape drive should be tiie basic name of the tape drive on the tapehost. 
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2} Tape dirxv^ « ^tO 

5) T<ip^ Ijpst * Jl<?<?ifklh.<?^st;; ^127,O^0^iJ 






*4'):^ "*<!i04l.ti»^** r 'l^t^^iOttj?" r 





: 




- 






^ ^ 




"r '^Cd»<«fel'^r .0« 


^ ?*4eor 







_y 



Figure 60. Media Identification Menu - Local Tapehost 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's / j*hosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless yournetwoik uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Qass C networks). A leading 'Ox' is necessary if entering 
the mask as a hexadecimal number. A leading *0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Internet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 

Figure 61 shows the Media Identification menu of a system that was booted from 
a remote tape using tape device stO (SCSI address 4). 

When the details of the tape drive have been entered correctly, enter continue. 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost'. Figure 62 shows the Installation media type menu 
with the CD-ROM parameters set to install fi-om CD-ROM. 
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Figure 61. Media Identification Menu - Remote tapehost 
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Ijjstjfkllation. li^edia. Identi-ficatioti 
i) Inctallation niedia type ^ CD'-HOlSl 
3) iKJCsstl Xntemet address *i^ D-0-0,& (required for r-emofce tapet} 






Figure 62. Installation Media Identification Menu - Local CD-ROM 
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Network and remote CD-ROM Installations 

Installation media type must be set to Network 

Installation directory should be the full path name of the location of the installa- 
tion area, or the full path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /usr/cdrom, then the installa- 
tion path is simply /usr/cdrom. 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /j*hosts file. Check /etc/hosts or the NISAl^ 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Class C networks). A leading *0x* is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Network host must be set to the name of the system with the installation directory, 
which is used to determine it's Intemet address. The name itself, however, is not 
especially important (it is discarded after the installation is complete). As such, the 
default name, tape-n-boot-serv, generally need not be changed 

When the details of the media have been entered correctly, enter continue. 

Root Files Installation 

Next, you are asked if you want to install just the mandatory root files. This is asked 
as a confirmation before starting the installation: 



for beip) t 

After entering yes, the installation is performed. When it completes, you will be 
returned to the ramdisk menu. Reboot the system. 

The steps taken during the installation are: 

1 . extract miniusr. This contains the installation software, as well as enabling 
swapping. 

2. create filesystems (root(/), possibly /var or /tmp, as well as any new 
filesystems requested via the partition tool) 

3. create device entries 

4. install mandatory root files 

When installation has finished, the ramdisk menu is displayed (see Figure 63). 
If tile installation failed, call Customer Support. 
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Figure 63. Ramdisk Menu 

5. Invoke the Bourne Shell by selecting 3 on the ramdisk menu. 

• Before rebooting the system, edit the /etc/hosts and /etc/hostname.eiO 
files. The /etc/hosts file must have the name and internet address for the 
system on which you installed the operating system. 

• The /etc/hostnaine.eiO must contain the name of the system on which you 
installed the operating system. 






6. "^D at the ramdisk prompt to return to the ramdisk menu. 
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Rebooting from the Ramdisk 

After a successful installation, start UNIX by rebooting as shown in Figure 64. 

<- ^ 

1) Change Oi«k ■e^a^i1;i«tai«!Br 
^) Xn stall -Softw^E©- 

A^ Reboot Syatetin 



V 



•\ 



Figure 64. Ramdisk Menu 

Enter number of function to execute (* 1 *..'5', or '?' for help): 4 
At the Reboot System menu select Boot Unix: 

After selecting 1, there is a short pause, and then: 

B0^> boot 

Boot. ; a^ii.:sl {&^ D, 0) /ifttttifiix 

Entry: OxMOaODOO 



lSa2 

t I » X ^ i 
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Now you must specify the system configuration inforaiation must be specified. 

After Installing... 

Initial Boot System Configuration 



When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



1992 



Thur May 2B l^*SSi4Z PD?P 19^2 



«e«d to ba s-et fcw&fox^ th^ -By^tam caj? coma mp feo jRulti~us«r 
^at. Is thi-^ 3?y st-.'est^ ^ aaiae (d'^-f-ault •« ^standaXotien * 

192*:^.3-4J? <&Btttm> 

What iiS tlia network broadcast mask ^default ** Ox:£fff£fOO)? 

^hat is the iJXS domaia nama piiotia^ £or nona, defattXt *« 



V 



• ••NOTE*** 
Using the default 'none' disables the NISI YP services. 
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-J 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has himg up during tlie boot process, press the Reset button.. 

• • • NOTE • • • 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 



jf* t f i 



If the system booted successfully originally, you may instead log in as root: 



itJT-eia^ 3fO$iU; s;^otJ 




In either case, if a file exists that tells the system it has been configured, remove it: 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

C#'«Xit ) 

Otherwise, use fastboot: 

C# /^^Wie^tft^oot "• ' ' ' s 3 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Installing on a Series S4000 



Loading the Ramdisk 

The following explains four different methods of loading the ramdisk. After you 
have loaded the ramdisk continue on to the Dataless Installation section. 

Loading the Ramdisk via a Local Tape Drive 

Turn the system on. After the system passes the self-tests, the system displays the 
bootROM prompt. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to detennine if a system needs to have the basic operating system in- 
stalled. Set the value of this variable to before loading the ramdisk: 



^ROM> ^^t-^!tj» i3Ei$i.$.Xieei ^ 



3 



The system asks if you want to re-instaU if INSTALLED is not 0. 

To load the ramdisk on Series S4000 systems using a local tape drive, enter a boot 
command in the following fomi : 

1} ^apQ 

Eatj^t 4$:Viee tiP^is i 

You lu^Vift th$t jSfllXOWiii:^ ijape <Ji:it>'e$» Me^»i$ <;J^<SO^e On$P 
1> At ^ar9et4^ drive aaatet AR<i8IVE VIPSR ISO 21247-005 
5) At ^ar^etS^ drive txame** feXi5^XtSJ l&ISB-d^m '251^ 

B»t«:r device sxaRbea:: 1 



The bootROM copies the ramdisk image into memory and boots it: 



E»try: Ox:^dOe<JOO& 



The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses for up to three minutes. Proceed to the Dataless 
Installation section 
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Loading the Ramdisk via a Remote Tape Drive 

The system with the tape drive, referred to as tapehost in the following example, 
must be on the same netwoik as the system being installed, referred to as hamster 
in the following example. For example, with a class C netwoik, the first three num- 
bers in the Internet addresses of the two machines must be the same, such as 
192.1.3.4 and 192.1.3.1. Also, hamster musi be listed in /etc/hosts, or in the NIS/- 
YP hosts database, and /.rhosts on tapehost. In addition, the ethemet address must 
be in the ethers database. The ramdisk must be extracted from the OS/MP 4. IB dis- 
tribution tape onto a disk on tapehost. 

Since the system uses tftp(l) to load the ramdisk image, it must be enabled on the 
tapehost. Examine the file /etc/inetd.conf. A line similar to the one below should 
be in the file: 

(tf tip dg-ram udp i»alt r^ iri^tftpd -^s 

If the line starts with a #, remove the #. 

If a -s appears after the last in . t f tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 



/f«I>el%o$t I j>d ax i ft^jcr^iJ i?J»td 



The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

(^ taipefaoAfc I- Mix ~HU^ pid. 3 

Put the distribution tape into the drive and execute the following commands. 

tapehost must also be running rpc .mounted(8) nf sd(8) and ra3:pd(8) 
daemons. 

• ••NOTE*** 

In the following example the install kernel will be named IvarltmpI install. The ac- 
tual name of the file is not important, so long as it is used consistently here and in 
the example on the next page Also note that thefilesystem must have enough space 
to hold the install kernel. 
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For Exabyte tape drives, use bs=1024 instead of bs=512 in the dd command shown 
below. 



^as.^.. * ^ /-/--^ 



^^-^ i"" i Ti iiin f T-r - If lit -i n r i mti f f - n i i ^''^ 

Enter the following boot command:. 

^ __ ■■ """' ^ 

|3fei.<:^ tyi>i$ <>t <aevi<5^ -diO you ^i«}i to ija^t-Sii^J^ ^sojia'* 

E»t=B«. di^viee type t 2 

Sjiter iat^Kn^t addre»^ o£ tMa system {de£ai^lt*»a^^b»<j^d) i 

Snter intejitiat address of remote tape system 

Usln^ IF adcEress. 1Q2- 9,3*4 «* C00M3a4 
Server «t J£F ad^resa 192*9*3*1 ^ C00903ai 
BOflt-; tft|?x-&iC,l^l)/vSiJf/feffii/iii^t4li 






J 



In the example above, the variable hostnumber should be replaced with the last 
of the four numbers in the system's Internet address. 

Loading the Ramdisk via a Local CD-ROM Drive 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 
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The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to detemiine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as foUows: 

( fik;ag> ".gM&^i^ .'..".".''."'".. '"' ." "."."''''.!"...■" I"' '!' '^ 

The system will ask if you want to re-instaU if INSTALLED is not 0. 

Install the OS/MP 4. IB CD-ROM disk into the CD-ROM drive. 

To load the ramdisk on S4000 systems, using a local CD-ROM drive, enter a boot 
command of the following fonn: 

(lf;«;i^>l?c>ot'$<3 ") 

The bootROM copies the ramdisk image into memory and boots it: 



/§^i^tV'M',^i(y^,V/^mt^%^ 

The system displays a spinner while copying the ramdisk into memory. When the 
copy completes, the spinner pauses up to three minutes. 

Loading the Ramdisk via a Remote CD-ROM Drive or the Network 

Loading the ramdisk from a remote CD-ROM drive is essentially the same as load- 
ing the ramdisk fix)m an image area of the OS/MP 4. IB contained on a remote disk 
accessed over the network. The command to load the ramdisk depends on the type 
of system. 

Power on the system. After the system passes the self-tests, the bootROM prompt 
is displayed. 

The ramdisk installation software uses the value of the bootROM variable IN- 
STALLED to determine if the basic operating system needs to be installed. Set the 
value of this variable to before loading the ramdisk as follows: 

(^I?i0tj> '" "' "" '"" ^^^^^^'^'^^^^^^^'^^'^^^'^^^^ ^^^^^^^^^^^^ ' ^ 

The system will ask if you want to re-install if INSTALLED is not 0. 

If you are installing by a remote CD-ROM drive (via the network), install the 
OS/MP 4. IB CD-ROM disk into the remote CD-ROM drive. Create a mount point 
directory (if one doesn't exist), and mount the CD-ROM drive on the remote ma- 
chine, referred to here as diskhost, as follows: 
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The remote system diskhost, must be on the same network as the system being 
installed. For example, with a class C network, the first three numbers in the Inter- 
net addresses of the two machines must be the same, such as 192,1.3.42 and 
192.1.3. 17. Also, the local machine must be listed in /etc/hosts, or in the NIS/YP 
hosts database, and in /.rhosts on diskhost. In addition, the ethemet address 
must be in /etc/ethers, or in the NIS/YP ethers database. 



diskhost must have /cdromin it's /etc/exports file, and must also be 
rurming the xpc .mountd(8) n£8d(8) and rarpd(8) daemons. 

Since tftp(l) wiU be used by the system to load the ramdisk image, it must be en- 
abled on the diskhost Examine the file /etc/inetd.conf. A line similar to the one 
below should be in the file: 

f^ttp dgra«i u^ mit ^a<>t; /uar/eto/ln.tfltpd ixi.t^tpd ^s \ 

If the line starts with a #, remove the #. 

If a -s appears after the last in . tf tpd in /etc/inetd.conf, either remove it or use 
the directory /tftpboot instead of /var/tmp in the example below. Approximately 
6 MBytes will be needed in the directory used. 

If /etc/inetd.conf has been changed, inetd(8) must be told to re-read the configu- 
ration file: 

<^akbost # ps a^ii 1 sgt^p iBBtd : N^ 

The pid of inetd is the first number on the line that doesn't contain egrep. In the 
above output, pid is 249. 

(jkM^^MlfiM^ '--^ '^ 

Enter the following boot command: 

(■ROM> ii> t£feg>>,i$iC^^-feia'^tttaffifeg?r)/odrr<>itt/lit^tAll>s40^ ) 
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Dataless Installation 

After Booting Ramdisk 

When the ramdisk is booted, it first determines what sort of terminal is being used. 
If it is a serial terminal, that is, a tenninal attached to the ttya/ttyb port, or if the 
bootROM variable CONSOLE is not set, a hst of supported terminals is displayed 
as foUows: 

4) i^im 
$) t^i^^l 
6) vtlOft 

ftiat type of terminal ^gra you ixg^ing pl^w^7^)^' y 

If you are using a frame-buffer as the console, select the 4, the sun terminal type. 



♦ 



r 3Sh.aii type of teratinal are yoa using {^1* ^,^l*\*i 4 



3 



If the value of the bootROM variable INSTALLED is non-zero, the mandatory 
system software has already been installed. In that case, the system displays the fol- 
lowing: 



^^_;____™__,,_ 



~™^ 



Bo you--wa»t: to re^tinjstall the system {'^yes'^jr ^no-S ^'^ ^*^* 
\ gqy It^Xp)*? ^ / 

The above message is for the benefit of users intending to re-install the system soft- 
ware, but have not reset the INSTALLED environment variable. 

If the message appears, enter yes to re-instaU the mandatory system software, or 
no to continue the installation without re-instaUing it 
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The disk drives attached to the system are then scanned, and a menu of procedures 
is displayed: 



k 



"^ 



Eater fttimibex of ftmction to ^st&ftute < "^1' , ^ *5% or ^t-^ for 
\j ^«^p> ; ^ 

The provided functions are described below: 

Change Disk Partitioning - Allows changing the sizes of disk partitions, and 
whether those partitions are for filesystem space, swap space, or unused space. 

• ••NOTE*** 

If changes are going to be made to the disk partitions on which OS/MP 4. IB will 
reside, the changes must be made before installing software. Disk partitions not 
containing OS/MP 4.1 B can be modified before or after the installation. 

Install Software - Intended primarily for installing new systems. If system soft- 
ware has already been installed, then this option may be used to install any Sol- 
boume software distribution, such as X Windows. 

Invoke a Bourne Shell - Starts an interactive Bourne shell. This option is provided 
mainly for formatting disks and restoring filesystems. The sizes of disk partitions 
should not be changed here with the fonnat(8) command. If they are, you must then 
select Change Disk Partitioningbefore attempting to Install Soft- 
ware. 

Reboot System - Starts UNIX after software installation. Alternatively, you may 
reload the ramdisk fix)m scratch. 

Halt System - Returns control of the system to the bootROM. 
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Help may be requested at any ramdisk prompt by entering a question mark by it- 
self.Table 22 shows edit commands available when entering text in response to 
prompts: 



Table 22. Input Editing Commands 



Character 


Interpretation 


backspace C^H) 


delete last input character 


delete C^?) 


delete last input character 


'^U 


erase input line 


AR 


redisplay input line 


AW 


delete input up to 7' or whitespace 


k: 


cancel input, returning to nearest menu 


ESC 


cancel input, returning to nearest menu 


'^L 


redisplay entire screen 


return C^M) 


end input 


newline C^J) 


end input 



If a string is too long to be displayed in the available space, the begmning of the 
string is displayed as ** . . . ". This allows display of the end of the string, which is 
usually of more interest. 

Keywords can be shortened to any unique prefix (such as *co' for 'continue'), ex- 
cept for 'yes' and 'no', which must always be spelled out. 

Fatal errors during software installation are usually reported by messages begin- 
ning with System error or Internal error and ending with a "#" 
prompt. If a fatal error occurs, software installation may be restarted by entering: 



# fid /^ 

# rm ♦«£ /csore 


J 



where '^J is the linefeed character. The command stty sane may not be echoed (and 
is intended to fix that problem). In the event of a fatal error during software instal- 
lation, please report the problem to Solboume customer support. 

Software Installation from the Ramdisk 

Installing software has two distina stages: gathering information and modifying 
the system. No permanent changes are made to the system until all information has 
been provided. 



Installing OS/MP 4. IB on a Dataless Client 215 



For a dataless client installation, there are two infonnational menus: 

D Standard Filesystem Definition - specifies where the standard filesystems 
(root (/), swap, and /usr, optionally /var and /tmp) are located. 

□ Media Identification - Determines the installation media fix)m which to install 
(tape, CD-ROM, or network directory), and determines where that media is 
located. 

Both menus provide the conmiands cancel and previous. These commands allow 
you to return to prior menus, optionally discarding any changes that have been 
made. 

cancel always returns to the ramdisk menu. If changes are to be discarded, then all 
changes made since install Software was selected are forgotten. 

previous always returns to the previous menu (which is the ramdisk menu, in the 
case of the Filesystem Definition menu). The changes discarded in this case are 
those made in the menu you are leaving. 

cancel has higher priority than previous. In other words, if you use previous to 
leave a menu without discarding changes, then cancel from tiiat menu and discard 
changes, the changes made in the earlier menu are also discarded. 

Standard Filesystem Definition 

The Standard Filesystem Definition menu defines where the mandatory filesys- 
tems are located. These filesystems (except for root) may be either on a local disk 
partition or provided by a disk server. If root is to be on a remote system, install the 
system as a client of that system. For a dataless system, the /usr files should have 
^ready been installed on the server. 

Any changes made to the standard filesystems with the partition tool will appear in 
this menu. 

Changing an entry at the Standard Filesystem Definition 

To modify the /usr filesystem, enter the number 3. 



BRt«r jwunber ot £il«3yst-«m to chaage {"^I^k^^S'J* 



3 



The usr menu will be highlighted, and the system will request a disk partition. As- 
sign it to rootbeer:/export/exec/S4000. 

The new arrangement is displayed as shown in Figure 65. 

The following steps assign the /var filesystem to sdOd, rather than using the default 
of /var being a partition of a local disk. 

These steps are optional. If followed, the result is a filesystem definition that is the 
same as that supplied on the factory installation of a diskfiil system. In addition, it 
makes use of partition d, thus using 9.3 MB of disk space that is not used when the 
default disk partition is used with the standard filesystem definition. 
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In Figure 65 shown below, the notation "(required)" appears next to the root(/), 
swap and /usr filesystems. These filesystems must be defined; however, they may 
be placed on any partition of any disk. 



StHndaxd E^JLleayBtem. Definition 

a) /U6x' re>otbeej£3/^x.jj<!>rt/««t6<!;/S4000(jtf6<5<iije6d> 

4) /v&r t>n root -psj^t-itictft 

5) /ttiip eat root ^£tit-±t>ti 



adi: 8.^4 32*7 



(o) (d^ ie} (f) ^gr) <h) 

l»l,i $*3 14X,I 

190*^ S,^ 140,8 



t5»56i$-x ttnimb^r of fii^o^ypt^ffi to <?iiftttg-<? <"!.•*♦,''$'')* "co^tfliow^^ ^prei^iou^'' ^ 



V 



J 



Figure 65. Sample Standard Filesystem Definition Menu 



To modify the /var filesystem, enter the number 4. 



Q 



^c-Oiittitme*' ^ ^previ^us^y ^la-gtactQel^ or ^?^ for help: 4 

The var menu will be highlighted, and the system wiU request a disk partition. As- 
sign it to sdOd. 






filesy steals ^n.otie* # -^C^ ' or '*?'' for helpi sdOd 



The new arrangement is displayed as shown in Figure 66. 

Once all changes for the standard filesystems have been made, enter continue 
to proceed to the Media Identification menu.: 



MtBx nmsbBT of filesystem. to chawg-e C^X' > . '*5*'3 r 
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»i ii II I III mi I I I ] I I I. II I II I I I I I I I I ] II iiii I 1 1 1.11 ' I I I I I' I 

Disk l^axrti'txort^ {exsea in 1<^} 
(^> ^t>J <<>} {<?) 1^) {:ej ^^J <h^ 



sdQt 8*4 32.4 19^3,^.1 9*3 — - -— ^ 141*% -*--- 
$aii $*4 5^."? 1»0»^ ^♦^ -^-^ — - 140*$ --«' 



B3ftti^ei» a««^$r ojf fil«si-y-afe«ai t<> <?b.^»9« Vl**x^^*ir 'co)otia'a«f''r ^jp^^viott^' r 



Figure 66. Modified Standard Filesystem Definition Menu 

Media Identification Menu 

The Media Identification Menu describes which media will be used during the in- 
stallation. 

On Series S4000 systems, the default values are detennined by how the ramdisk 
was booted. 

Figure 67 shows the Media Identification Menu of a S4000 machine that was boot- 
ed from a local tape device stl (SCSI address 5). 

Installing from a Tape 

Installing from a local tape drive requires that the Tape drive field be set to either 
stO or stl (the only supported tape drives) and that Tape host be set to 'local- 
host'. The Installation media type must also be set to 'Tape*. 

Installing fi-om a remote tape drive requires that all the fields be set: 

Installation media type must be set to Tape. 

Tape drive should be the basic name of the tape drive on the tapehost. 

Tape host must be set to the name of the system with the tape, which is used to 
determine the tape host's Internet address. The name itself, however, is not espe- 
cially important (it is discarded after the installation is complete). As such, the de- 
fault name, tape-n-boot-serv, generally need not be changed. 
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i 2) Wsipm drive ^ atl 



Sa^^(^!c &^l^ction nuv^^t ri^^^M^K ^eofttirttt^^ '^j>r^vl<>»a' ^^ '^fiaftc^l!, oti "^'^tot 



Figure 67. Installation Media Identification Menu - Local Tapehost 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /j-hosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Class C networks). A leading *0x' is necessary if entering 
the mask as a hexadecimal number. A leading '0' is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. 

Figure 68 shows the Tape Drive Identification menu of a system that was booted 
from a remote tape using tape device stO (SCSI address 4). 

Local CD-ROM Installation 

Installing from a local CD-ROM disk drive requires that the Installation media type 
be set to CD-ROM, the CD-ROM drive field be set to /dev/srO and the CD host 
field be set to 'localhost*. Figure 69 shows the Installation media type menu 
with the CD-ROM parameters set to install fix)m CD-ROM. 

Network and remote CD-ROM Installations 

Installation media type must be set to Network 
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r 



3J i.<:>Cdi Internet a>deljre^» ■« I9J?^9+3*4 ^t«<$EUJl3re<J for remotfet tape} 



Sitter «$l.^tioiD ^Xk'S^h^x 
help: 



\ 



C^i'**M*^^ '<jo/^tift«e.* r 'p-ifevXo«H9% .'^■ca»<t«i^ r -o-sc ^l*toti 



Figure 68. Tape Drive Identification Menu - Remote Tapehost 



J 



r 






Icbe1:al latlon l!le<Sia I<iei3t.l£iaation 



\\ IrtafcaXi anion media type «> CD-^ROM 

I?) CD «:Jrlv«i « M^V^/^XQ 

3) liocal Ixttemet a^.^reasc -^ 0-4.0.0^0 {required £ox remote t.ape) ' 



^?tte?r 4$i©:0ti?>n ¥i¥ittit>«er (^1'',,''$*K ^<?aot.iflue% ^DKjp^vioojp-* , ^<i«R<?eX% o?; -^iP^fo-j: 



Figure 69. Installation Media Identification Menu - Local CD-ROM 
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Installation directory should be the full path name of the location of the installa- 
tion area, or the fiiU path of the CD-ROM mount point, on the network host. For 
example, if the remote CD-ROM is mounted on /usr/cdrom, then the installa- 
tion path is simply /usr /cdxont 

The Local Internet address is the address of the system being installed. If the de- 
fault value is not correct, make sure that the client name corresponding to the cor- 
rect address appears in the tape host's /j-hosts file. Check /etc/hosts or the NIS/YP 
hosts map as appropriate. 

The broadcast mask should not be changed unless your network uses a non-stan- 
dard mask. Such a mask is used when a network is sub-netted (i.e., a Qass B net- 
work is treated as several Qass C networks). A leadmg 'Ox* is necessary if entering 
the mask as a hexadecimal number. A leading '0* is needed for octal numbers. If 
neither prefix is given, the value is assumed to be in decimal. Network host must 
be set to the name of the system with the installation directory, which is used to 
determine it's Internet address. The name itself, however, is not especially impor- 
tant (it is discarded after the installation is complete). As such, the default name, 
tape-n-boot-serv, generally need not be changed 

When the details of the media have been entered correctly, enter continue. 

Root Files Installation 

You are then asked if you want to install just the mandatory root files. This is asked 
as a confirmation before starting the installation: 

\ £or hetlp)*? ' j J 

After entering yes, the installation is performed. 
The actual installation begms at this point. 
The steps taken during the installation are: 

1. extract miniusr. (This contains the installation software, as well as enabling 
swapping. The root disk might not be repartitioned after this step without 
requiring reinstallation.) 

2. create filesystems (root(/), /usr, possibly /var or /imp, as well as any new 
filesystems requested via the partition tool) 

3. create device entries 

4. install mandatory root files 

When installation has finished, the ramdisk menu is displayed (see Figure 70). 
If the installation failed, call Customer Support. 
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r 



^gmdi*k 



4) Reboot S;i?st^m 
5 J ${g.3it- System 



^jiter nuudof&r af jfunation to- exe<?^t.& <*•1'■♦,'^S'^^ ox ^f^ ^for jMslp); ; 3 



Figure 70. Ramdisk Menu 

5. Invoke the Bourne Shell by selecting 3 on the Ramdisk menu. 

• Before rebooting the system, edit the /etc/hosts and /etc/hostname.eiO 
files. The /etc/hosts file must have the name and internet address for the 
system on which you installed the operating system. 









• The /etc/hostname.eiO must contain the name of the system on which you 
installed the operating system. 

^^^^_^™____™™_ X 

gtramdiskf 



6. '^D at the ramdisk prompt to return to the ramdisk menu. 
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Rebooting from the Ramdisk 

After a successful installation, you must have first ran config_server on the server 
before booting UNIX as shown in Figure 71. 



. . ^ 

; %\ B<?<?tp Unix 

i t} Boot <n\ raflxai^k 

\ EGt«r Eelection ovmiber < ^1*^***3*) or '"^* for help: 1. 

I : _J 



Figure 71. Reboot System Menu 

Enter number of function to execute (* 1 './5', or '?' for help): 4 
At the Reboot System menu select Boot Unix: 



([snt^E ^i$l^Ctifrft iitafltb^t {"^t* ,.^V} o£. '^'7^ ton, h^lpj 1 ^ 
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After selecting 1, there is a short pause, and then: 



.^ 






At this point, the system configuration information must be specified as described 
in the section i4^er //wto//m^... 
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After Installing... 

Initial Boot System Configuration 

When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



OS/m ^a^JJagporfc iimmaC/TCO<it) #0; 'JJwfit way Zi a0;00fl3 
1595 

Copyright io)f i98 9-1351 ^xin. Microsyatemsr Ino* and 



I » • ■• J 

chepking quotas: don,©* 



•^ibi* :$y$-t*«t. ixSi^ ftOt yi$t b^^o cisonf i5rft?r!$<A» Si^T^-e^sr^Jl v^Iu^^ 
jaee<:i to h& set befoxe the system can coma tap to mult leaser 

Mt$t i$ tiiia $Y$t0ttfi$ nam^ (de-f^ult "■ *$t^fldalon$^' ) ^ 

l^at is.it^ XAteyrt^t ;&ddyi0^i$ (0 fOxr noo^r d^^a^Ilt » 
152,:&.3.4)^ <fte:tum> 

Sjtiat is the network broadcast ma;sk tdefatiXt * Ojx^ffff-fOO) ? 



V 



• ••NOTE*** 
Using the default 'none' disables the NIS/YP services. 
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•Australia/ 

Bx^ziX/ 

Canada/ 

Cuba 

Ml! 

Factory 



choice » eitei 
GMT-fll 

GM3^+3 
GM.T+5 

(SMT+8 



^ 






fptra7 
<3MT8 

Qr<5e£)iwi<fh 

ss-f 

Ho«gkorvg 

tarael 

Japan 

MET 

«S^7M)T 
Ma2?i,cp/ 



ISSideast;/ 
IfavajO 

Pol anct 
ROC 

'[furkey 
tJCT 

OnlvBrsal 
"WET 



{*/' xrtdiCdtli'ej* time 2on«> prefiifie*) 



Bntiar tinie zan© {default ^^ ^CTS/Iiountain^ ) : XT3 KRetriiru^ 

Alaska Ceatxai Hawaii S^aaific 

ai'^utiatt E^t^t-^JnUi^nSr Mlchi^raja i*a.oif"ic:-'}i<iw 
jMMa:6ila Saat-esrxi Wotantaiii SsjjKiHSk 

!»b^t is i?<?<3fky' 9 dftto (fflm/dd/y:yyy,. dotau^t ** 05/2^/1 ^$2} ? <Returi»> 
SJhat tima ia it ^24^1iour hhiJiuu, de.faxjlt « 16:SS)? <Retlum> 



Hoet. natne 

Not work mask 
iriS^ doradijiii 
ll"ijn& zone 
&atfi (Bi/d/y) 
^imes 



*!! habit rail 

■ft"- Oxf fffffOO 
«■ Rod^iit»CCW 
■w OS/Mountain 

» 16:55 



Setting tietmask of oiG to 2S5.255,2S5.0- 

Txi^ 0^<;t= 11 2!2 5<^9fPO MST 1$90 

Set-ting password for root 

Chdrtgiftg f>a5$wox<3 for root on ivabitrail- 

iJew paasword: 

C&rttifxuing boot 

^t^rtiog rpc and. n^at servioes.: portmap I 



'I 
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Reconfiguring the System 

You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, cycle the power off and on). 

• ••NOTE**Tif 

If automatic boot is enabled it is necessary to interrupt the reboot by typing Con- 
trol-C in the early stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 




If the system booted successfully originally, you may instead log in as root: 






In either case, if a file exists that tells the system it has been configured, remove it: 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

(# "^ii^ "^ : " "^^^ ) 

Otherwise, use fastboot: 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Before Installing... 



Installing OS/MP 4. IB 
on a Diskless Client 



Any host on a network must be added to the hosts database. Before you can add a 
host to either database, a name and an address must be chosen for that host. Be sure 
both are unique for your netwoik.There are three forms of netwoik information da- 
tabases to be considered. 

a Static files - this is the simplest form of the databases: two files, /etc/hosts and 
/etc/ethers. 

□ Network Information Service - NIS, formerly called Yellow Pages (YP), is a 
centralized version of the static files approach. Fundamentally, one system, the 
NISAHP master, uses the static files. Other systems ask the master to look up 
entries in its files. 

□ Domain Name Service - DNS is part of the software used to administrate the 
Internet, and is beyond the scope of this document. If you are using it, contact 
your system administrator for information on updating entries in it 

If you are using NISA^P, the following actions must be taken on the NIS/YP mas- 
ter. If you are using static files, these actions must be taken on the system that is to 
act as a server (by providing either its tape or disk drive). Only the superuser (ac- 
count name root) is allowed to update these files. 

First: Update the hosts database with the name and IP address chosen for the new 
cUent by adding a line of the following form to /etc/hosts: 

192.1.3.42 hamster 

Next: If you are installing a diskless client, update the ethers database by adding a 
line of the fonn below to /etc/ethers. The six colon-separated numbers are the ones 
displayed by the system when the power is turned oa The name must be the same 
as was added to the hosts database. 

0:0:8e:10:0:16 hamster 
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Finally: If you arc using NIS/YP, the woridng copy of the database must be updat- 
ed: 







Installing... 



• ••NOTE*** 

The make command should be executed on the NIS/YP master server only. 

Before installing a diskless client, you must have already installed the server. On 
the server, you must also have run config_server for this client's architecture, and 
you must have run install^client for this machine. Refer to Installing OS/MP 4. IB 
on a Server for details. 



Setting BootROM Variables 



The Solboume diskless client must have the proper bootROM environment vari- 
ables set, in order to boot from a server by default. The following tables list vari- 
ables that must be set on a Solboume client 

Table 23. Variables that Must be Set on a Solboume Series 5, 5E or 6 Client 



Variable 


Sample Value 


DEFAULTROOT 


ifip,ei(„hostnumber) 


DEFAULTBOOT 


/e\port/root/clientname/\mumx 


DEFAULTSWAP 


/exportlswap/clientname/swap.clientname 


DIAGBOOT 


/export/exec/Series5/kvm/stand/dg/or a SeriesS 
client 


/export/exec/Series6/kvm/stand/dg/or a SeriesS 
client 


DIAGSERVER 


tftp,eiiJiostnumber) 


CONSOLE 


bw0.cgO,zsO,orfbO 



Table 24. Variables that Must be Set on a Solboume Series S4000 Qient 



Variable 


Sample Value 


DEFAULTROOT 


tftp.eii„hostnumber) 


DEFAULTBOOT 


/clienis/rooi/clientname/ymunix 


DEFAULTSWAP 


/c[ients/swa.p/clientname/swap.clientname 
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Table 24. Variables that Must be Set on a Solboume Series S4000 Qient 



Variable 


Sample Value 


DIAGBOOT 


/clients/exec/S4000/kvm/stand/dg 


DIAGSERVER 


tftpMCMostnumber) 


INPUT-DEVICE 


keyboard, ttya, or ttyb 


OUTPUT-DEVICES 


screen, ttya, or ttyb 



In the tables above, clientname represents the name of the diskless client and host- 
number represents the last portion of the internet address of the server. For exam- 
ple, if the server's Internet address is 192.9.201.134, the hostnumber is 134. 

The acceptable settings for CONSOLE depend on the version of the bootROM in 
the system. 

The diskless client must have the proper bootROM environment variables set to 
boot from a server by default. To set the variables: 

Turn on the client. 

Set the following bootmode variables: 

In the commands above, clientname represents the name of the diskless client, 
and hostnumber is the last portion of the internet address of the server. For ex- 
ample, if the server's internet address is 192.9.201.134 the hostnumber is 134. 

The type can be SeriesS, Series6 or S4000, or a directory name comprised of a 
basename standing for the machine architecture and an extension standing for the 
operating system and release level, as created by the -n option of config_server; 
for example, S4000.osmp.4.1A. 

Set the BOOTMODE to auto and reboot: 

/k0U> setieav boot^iode auto N 
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• ••NOTE*** 

If the system reports a protocol error while attempting to boot, kill and restart in- 
ttd(8) on the server. 



After Installing.. 



When a newly installed system is booted multi-user for the first time, the system 
asks a series of configuration questions: 



1995 

Copyright (c> 19-aS*1^9i Sun Microsystems^ Ino* and 



t..J 



ohetckixig quota is j. doyie^ 



2?l^$ -^sy^ti^gii Mjs not j^t b^^n <j«afi^c^4< 35^v^e^i vaXu^s 
need to be sest befor-e the ^a^^istem can. come tip to tftiiltl^^user 

KHiat. ij3 t^l.$ ^3?8-t0nt*$= Am^ (4e£3alt ■" *8tai^4aLliaii$'' ) J 

192. St .3* 4)? <Ret.u«n> 

«[hat is ttie »etMi35k broadcast laask (default *»• Oxf€ff£fOO):? 

ISftat. is tit^ HI^S "doataift nairto- ^^inaii^'' £<3r rion^^ d&fatilt « 



* * * NOTE * * * 
Using the default 'none* disables the NIS/YP services. 
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Australia/ 13M.T+11 



Brazil/ 
Ca£E&da/ 

KST . 

S'a-atory 
<3«1? • ■ 



GMT+5 



<3asx3 
0^$ 



<smt7 

<3MT& 
Japan 



Mideaafc/ 
ROC 

tlnlvarsal 



^ '^/'^ i.rtdi<!;ae.e.& t-Xme aiorwe t>tefX3{i:-^s) 



Eqti^r tiime- ?.ane {default. 
Jklaa ka Centra 1 



*f *tja/MouGtain.^J: I?i$ <Retail«ft> 



BawadLL 



^acsific 






Sftiat 



titiiife i^ xt ^24*li.oa3: Iih?*mi, <$e fault 



' l€:5Sj ? <38e%uwa> 



Host, name- 

]£}«t-'Worlc tnaek. 
WIS 4ottiai« 



■**• hafaitxrail 

*»■ . Qxff f f f £00 

*i^ GS/fetoimtain. 
* Q^/^e/1^52 
«■ 1$355 



&t« these -COiotect- (*ye«' Or ^ao'J;? 

Setting tietnjaBfc of" eiO to 2S5,255,2SS-^0 

^ttiag password for root 

Ch^n^ijfti^ |i^A5$wi>r<J foj: root ot» hatfeltJraiJt » 

iJew pajSBWord: 

R^typo «:^w jpta^^^woMt 

Coiitmuisig- boofi 

st.a?'ti?i^ rpc arid pet sei;y3:<?^fl(** po?rt^ap l . 



♦ I 
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Reconfiguring the System 



You may need to reconfigure the system if: (1) wrong value was set during the ini- 
tial configuration, or (2) the system did not successfully come up to multi-user 
mode. 

If you find that a wrong value was set during configuration, you can modify the ap- 
propriate file manually, or reconfigure. Manually correcting the settings should 
only be done if you are an experienced system administrator. Reconfiguring auto- 
matically is fairly straight-forward, as explained in the following procedure. 

If the system has hung up during the boot process, press the Reset button (for Series 
S40(X) machines, cycle the power off and on). 

* * * NOTE * * * 

If automatic boot is enabled, to interrupt the reboot by typing Control-C in the ear- 
ly stages of the reboot; otherwise the system will hang up as before. 

Then bring up the system in single-user mode: 

t-..3 J 




If the system booted successfully originally, you may instead log in as root: 



'1i^|fit£-aii iogiftt root 



In either case, if a file exists that tells the system it has been configured, remove it: 

(#' m"'/»fcft/jy^^ "^ ... ' D 

The above file may not exist; this is not a problem. Go ahead to the next step. 
Now reboot. If you are in single-user mode, exit: 

( # eatifc ) 

Otherwise, use fastboot: 

( # /iBte/fauiitboot^ ^ " } 

The system asks configuration questions just as it did the first time it booted after 
being installed. 
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Changing Disk Partitioning 

All hard disks are shipped with a default partitioning. Disk partitioning is useful 
for: 

D Changing the size of a partition 

n Assigning secondary swap space before installation 

n Assigning mount points 

OS/MP 4. IB uses the default partitions in the following way: 

Table 25. Default Disk Partitions and Filesystem Assignments 



Partition 


Filesystem 


a 


/ 


b 


swap 


d 


/var 


g 


/usr 



• ••CAUnON*** 

Changing the size of a partition destroys any information on that partition. 

• ••NOTE*** 

If you change the partitioning on the drive containing the root partition, you must 
reinstall the operating system. 

The following instnictions assume the ramdisk has already been loaded, as de- 
scribed in the Starting Disl^ul Installation section. 

After selecting Change Disk Partitioning from the ramdisk menu (as 
shown in Figure 72), a spinner is displayed while the partition tool starts up. 

Once its initialization is complete, it displays a description screen and asks if you 
wish to continue. Answering 'no' returns to the ramdisk menu. Answering 'yes' 
produces a menu of disks installed in the system (see Figure 73). If a disk is missing 
from this menu, verify that the SCSI address is set correctly on the drive, and that 
the cables are finnly seated. 
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r 



J^aflwptii^k' 



1> ch^ftg^ T>i?J«i 1?^?ri;itlonir»ct 
2> Install Software 

4> l^boat System 
5) Halt System 



£ut&E nomh&r of ftinafcion to execute ^[*1'*,*S*/ or '^i?' for help) j 1 



V. 



Figure 72. Ramdisk Menu 



r 



N 



^eleat Disk t:o J^artition or lievifew 



11 sdO (1^1*1 j«b) 



EDtaar <±lslt puathery ""T' ^ oir *«5?tt-'' « 5^ 



Figure 73. Disk Partitioning Menu 
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To return to the ramdisk menu, enter 'exit' at the disk menu. 

Select the disk you wish to examine and proceed to section, "Partition or Review 
Disk". This tool is also available on installed systems in /usr/etc/partition. 



Partition or Review Disk 



Upon selecting the disk you wish to examine, a screen describing the disk is dis- 
played as shown in Figure 74. 



MaJf sdO: 

to* 3-2*3 Mfegabjft^a 

g: 141.1 ttetgabyfc&s 



1. SLasize patrtiticai ; 



S^l,«dfl=et ^fitfisr ai^titt mumfcetr^ 



£^jEk3;tit-ioa or Sevlew UIaJ? 


^ 






































S, Caiange dxaplay 
S* tjftdo lA«t -actliC 


pstramaters 


7* IJAdO ALL ACtior 


it& 


$. ?i<rt;w3;:tt t<? VfJC'^^i 


.^q^t?? ffli^tt^E 












J 



Figure 74. Partition or Review Disk Menu 



To change the size of a partition, see "Resizing Partitions," section. To modify 
mount points, see "Changing Mount Points". For discussion of templates, see 
"Templates". Other available actions are: 

a Change display parameters - modifies how partition sizes are displayed, in 
megabytes, blocks (sectors), or cylinders/tracks/sectors. 

a Undo last action - does just that. Only the most-recent change is remembered, 
and undo counts as a change. Therefore, two undos in a row have no net effect. 

□ Undo ALL actions - discards all changes made since selecting this disk from 
the disk menu. It is possible to undo an undo all. 
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No changes are made to the disk itself until returning to disk menu. If changes have 
been requested: 



^ 



l^asQ eiit-er menw iiimta^rj 8 



template has he&n modtfl&d* Do you wisli to accept these 
^yBS* or '^na* to exit, any other input to continiie editing t 



Resizing Partitions 



This section demonstrates changing the size of partitions by increasing the size of 
partition d to 12 megabytes, taking the additional space from the g partition. 

First, select the resize partition action from the Par tit ion or Review Disk 
menu: 



C 



Please enter -menu niimberi 1 



This causes the Resize partition menu entry to highlight, and the following ques- 
tions to be asked: 



1 



Snter $iz^ Qf paEtition <3 ip iii^craljyte^ ? XZ 
Nj g^A^age gg)^oigy paxt-ifci-ot^ to ggntrii^^^tg t^.i$ 5p-a"c^e; ^ 

Figure 75 shows the updated screen with the new sizes. Observe that the d partition 
is not exactly 12 megabytes. This is because partition sizes may only be changed 
in fixed quantities detennined by cylinder boundaries (the number of sectors per 
track and the number of heads in the drive). 

Also, the tool is asking for another partition to resize. It will continue to do so until 
a blank line is entered by just typing <Return> at the prompt, Please spe c i f y 
partition to be resized: 

The default partitions can be changed during the install procedure. We recommend 
using partition c for the entire disk. 

OS/MP 4. IB supports booting from any configured disk, whether IPI, SMD, or 
SCSI (except in the case of an IPI or SCSI drive connected by a Multi-Channel Ac- 
celerator Board). For example, if you have two SCSI drives, you may choose either 
sdO or sdl as your DEFAULTROOT device. The root(/) file system may be on any 
partition on the boot disk. See section on page 25 for setting DEFAULTROOT. 
The installation tools and the supplied "GENERIC* kernels require that the root 
and usr file systems for IPI-based systems be assigned to partitions of the first four 
drives of the first controller. 



Changing Disk Partitioning 237 






\ 



Mpk ^dDj Maxtor V$.'t'-t^^ 
•TataJ, Di;^k Si-K^i 191.1 J4b 



At 6*4 
bt 32*3 

d: 12,1 
hi 0-*-0 



tflegabyteB 
iJegabytes 
i>ieg-abyt«a 



2. Change tni>unt po-intie: 
%, Ov«3ri«-y with •t-ea^i.atf^ 
4- S-tO*:^ ^^ tx&^ t^e«i3fjlati^ 



$^aWi.it.ji£>n or p^vi^w I3i4lc 



/ 



/«A$r 



6* Undo last aoCian 

8* Rettijtrt to pjtreviott^ «)0rtu 



E>le23i.9e ape-cify partiticwj to tofi; x«ai2«<$t Be'tllX^ 



Figure 75. Partition or Review Disk Menu - Resizing Partition 

The SeriesS, SeriesSE and Series6 generic kernels support four SCSI disks on the 
I/O ASIC SCSI controller as well as four VMEbus "xd" disk controllers. Each 
*'xd" disk controller can support four disks in the generic kernels. 

Example partitions for these drives are listed in the following tables: 
Table 26. Example EPI Disk Partitions 



IPI Disks 


Partition Use 


1.2 Gbytes 
512 byte sectors 


3.0 Gbytes 
512 byte sectors 


Sectors 


Size 
(Mbytes) 


Sectors 


Size 
(Mbytes) 


a 


/ 


18522 


9 






b 


swap 


65856 


32 






c 


all 


1679328 


820 






d 


/var 


20580 


10 






g 


/usr 


1574370 


768 






h 


unmounted 


N/A 


N/A 
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Table 27. Example SCSI Disk Partitions 



SCSI Disks (sdO) 1 


Partition Use 


327 Mbytes 


661 Mbytes 


200 Mbytes 1 


Sectors 


Size 
(Mbytes) 


Sectors 


Size 

(Mbytes) 


Sectors 


Size 

(Mbytes) 


a 


/ 


16800 


8 


16695 


8 


16800 


8 


b 


swap 


66150 


32 


66780 


32 


66220 


32 


c 


all 


639450 


312 


1292670 


631 


391300 


191 


d 


/var 


19425 


9 


19080 


9 


18963 


9 


g 


/usr 


537075 


262 


1190115 


581 


288960 


141 



Changing Mount Points 



Partitions that will contain fdesystems must be given mount points. A mount point 
is where in the directory structure the fdesystem wiU appear. Two filesystem 
mount points that must be defined on all systems are / (^so called root) and /usr. 
The following example shows how to define a new filesystem. 

To define a new filesystem named /bench on partition b, begin by entering 2 in re- 
sponse to the Partition or Review Disk menu: 



^iPi^a$<g'i^i:tWxr"'m&att"''ft^ 






This causes the Change mount points entry to be highlighted, and you 
may specify the partition and desired mount point: 

/th^xiq^ moxixkt point fox «hi-ofe partitiorx <or "^i^fi b 'N 

jKnt^c £ixll utii?: p^thns^m^ on wHtioJi to mOTtftfe t'hi^ partition/ 

«> /bench. 

The display is updated to reflect the new mount-point, as shown in Figure 76. As 
with changing partition with changing partition sizes, the tool is asking for another 
mount point to change. Entering a blank fine by pressing <Return> will return to 
the menu prompt. 

To define a swap partition, proceed as if defining a mount point, but enter either 
' ' swap " or " primary " as the partition name. Only one partition should be labeled 
primary. This partition is verified to be sufficiently large, and is presented lo the 
system as the primary swap space, however, you can add additional swap space by 
labeling the others "swap". The primary swap area must be at least 32MB. 

Other swap areas should be listed in the /etc/fstab file and enabled by the 
swapon(8) command from within the /etc/rc.local file. 
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Templates 



r 



lE^artittdott or R^viaw \>in\i 



Tptai Disk Si>gr©; 191.1 Mb 



32.3 



a: 
bt 



M«ga,bytei3 

Megabytes 
MegaJy^fces 

M:ei$fabyti«& 



/ 

/bench. 



tXt^X 






5^ cph^ng^ dtspi^y par^m^t^jps 
^< Qndo last a<ittion 
7, Un<io AJ^S* actions 



vr 



ChAf)-g^ mottftti. poliit foK wfei-cii jjart-iti-ofti l^atuano. 



y 



Figure 76. Panition or Review Disk Menu - Changing Mount Points 



Overlaying with a template is a fast way to change all the partition sizes on a disk 
simultaneously. Initially, only the Solboume standard templates are available. 
However, if a customized template is saved, it can be used just as readily as the 
standard templates. This feature is mainly used when there are several identical 
disks in a system. 

After a particular set of partition sizes has been settled upon, it can be saved as a 
new template (menu item 4). This new template is stored on the ramdisk, and so is 
lost when the system is next halted or rebooted. 

• • • CAUTION • • • 

Applying a template from one type or size of disk to a different type or size of 
disk is very likely to result in corrupted filesystems on the modified disk. Such 
a mistake usually causes a system panic at some point (possibly several days) 
in the future. 
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